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Preface 


MANUAL OBJECTIVES 

The SPM-11M Reference Manual is a manual describing the 
structure and use of the SPM-11M software supported by DIGITAL 
on RSX-11M operating systems. 

INTENDED AUDIENCE 


This manual is for all users of SPM-11M. 


STRUCTURE OF THIS DOCUMENT 

Chapter 1 is an.overview of the architecture of SPM-11M. 
Chapter 2 describes the components of SPM-11M, 

Chapter 3 describes how to use SPM-11M. 

Chapter 4 describes data collection and reduction procedures. 
Chapter 5 describes how to read the performance report. 
Chapter 6 delineates the resources used by SPM-11M. 

Chapter 7 is the usage notes for SPM-11M. 

Appendix A is a specification of the Hook Records. 


Appendix B specification of the Monitor Parameter Block 


is a 
(MPB). 
Appendix C is a specification of the Information Records. 
Appendix D is a specification of the System Metrics Record. 
Appendix E is a specification of the logfile format. 
Appendix F is a sample performance report. 


Appendix G@ is a sample SMPGEN.CMD procedure. 


Appendix H is a sample of installation of SPM-11M. 
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Chapter 1 


OVERVIEW OF SPM-11M 


The Software Performance Monitor (SPM-11M) is a software 
instrument used to measure the performance of a computer system 
running the RSX-11M operating system. 
SPM-11M is a natural counterpart to RSX-11M: while RSX-11™ 
manages the resources of the computer system, SPM-11M remembers 
how the resources were used over a period of time, similar to 
the way a tape recorder remembers a set of sound patterns. 
Moreover, SPM-11M has the capability of "playing back" these 
recordings of resource usage, so an analyst can study how and 
when the resources were used. 
SPM-11M is an event driven performance monitor. As each event 
of interest occurs, the performance monitor is called. 
1.1 RESOURCES 
The key resources of interest are: 

9) CPU 

0 Main memory 

0) 1/0 devices 

0 File system 

0) Task loader 
Note that a resource can be a hardware resource -- such as the 


CPU, main memory or an I/0 device; or a software resource -- 
such as the file system or the task loader. 
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1.2 USERS 


A user is the entity which uses the resources managed by the 
operating system. We define a user to be an RSX-11M task. Of 
primary concern is the workload the task places on the system, 
that is, how much and for how long the resources are used. To 
describe a task's workload we will define a set of metrics for 


resource usage. 


1.3 RESOURCE MODEL 


Because a number of tasks may concurrently request the use of a 
resource, and only one task may use the resource at a time, a 
queue will form for the resource. A simple queued resource is 
depicted as follows: 


The vertical bars represent the queued resource requests and 
the square represents the resource. Three intervals are shown 


on the diagram. "W" denotes the interval during which a task 
is waiting for the resource. "U" denotes an interval when a 
task is using the resource. "S" is the sum of "W" and "“"U", 


called the service time. 


1.4 EVENTS 
The activity of the RSX-11M operating system can be traced by 
defining a set of key events and recording a set of raw infor- 
mation associated with each event. The events of interest are 
those which capture the metrics of resource uSage. 
For example, we may want to know how long a task waits for the 
disk, how many times it uses the disk and how long it uses the 
disk. The following events are defined to capture the I/0 
activity: 

1. Queue 1/0 packet to driver 

2. Driver gets I/0 packet 


3. Driver posts I/0 completion 
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Applied to the queued resource model for the disk, these I/0 
events appear as follows: 


ares | aerea Ml a, 


1 2 3 


The complete set of events defined for RSX-11M is specified in 
Appendix A. 


Pe5 TASK METRICS 


The task metrics quantify the workload that individual tasks 
place on the system. S 


The task metrics are computed for all three types of intervals: 
U, Wand S. The performance report will contain a line of task 
metrics for each. resource used by the task. The task metrics 
are: 


(a) Count 


A simple metric for resource usage is a count of the 
number of times the resource was used during the life 
of a task. For example, if a task does four QIOs to a 
disk, the I/0 request count is four. 


fe) Total Time 


Another simple metric is how long the task uses a 
resource. For example, if a task did four QIOs and 
the I/0 requests took 20ms, 60ms, 10ms and 50ms to 
complete, the total usage time would be 140ms. 


6) % Resident Time 


Also of importance is what percentage the total usage 
time is of the time the task was in memory. For 
example, if the previous task was in memory for one 
second the percentage of resident time spent using the 
disk was 140ms/1000ms *100% = 14%. 
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0 Interval Statistics 


The statistical nature of the usage time is of key 
importance. 


The metrics defined for interval statistics are: 
- Minimum interval 
- Mean (average) interval 
- Maximum interval 
- Coefficient of Variation 


The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 


The coefficient of variation is of particular impor- 
tance because it tells whether the data is clustered 
about the mean (small c.v.) or widely scattered about 
the mean (large c.v.). In fact, if the c.v. is large, 
the mean may tell very little about the nature of the 
data, since very small values and very large values 
may combine to produce a mean which is not represen- 
tative of any real value. 


16° SYSTEM METRICS 


The task workload metrics defined above are useful for deter- 
mining who is using the system resources and how much each user 
is consuming. 


Also of importance is the performance of the system as a whole. 
To this purpose we define a set of system metrics. 


The system metrics vary as a function of time. To see how a 
given system metric varies with time, histograms are computed 
for the metric. Each histogram describes the per cent usage of 
a resource for one sampling interval. The sampling interval is 
a settable parameter described in Chapter 3, section 3.2.1. 
Creu 
The CPU can be in one of three general states: 

) User 


fe) Kernel (system) 


re) Idle 
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A useful metric is the per cent of time spent in each state, 
that is: 


re) % time in user state 
) % time in kernel state 
re) % time in idle state 


This gives us a general picture of how effectively the CPU is 
being utilized (% time in user state + % time in kernel state), 
as well as the overhead imposed by the operating system (% time 
in kernel state). 


Memory 


On RSX-11M the memory space is divided into partitions. The 
user can select one system-controlled partition for monitoring 
by SPM-11M. The performance monitor will compute the per cent 
of the partition that was in use at the end of each sampling 
interval and print a histogram. 


The user will most commonly select the partition "GEN" for 
monitoring. 


1/0 Devices 


The user can select one I/0 device to be monitored by SPM-11™ 
for system-wide uSage. SPM-11M will compute the percent of 
time the device was utilized for each sampling interval and 
print a histogram. If the device is mounted Files-ll, SPM-11M 
will compute the percent disk space used at the end of each 
sampling interval and print a histogram. 


Pool 


The RSX-11IM system pool contains the dynamically allocated data 
structures used by the executive. SPM-11M will compute the per 
cent of pool that was in use at the end of each sampling 
interval and print a histogram. 


Checkpoint file(s) 
SPM-11M will monitor checkpoint files allocated by the ACS 
command. The performance monitor will compute the per cent of 


all active checkpoint file space in use at the end of each 
sampling interval and print a histogram. 
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Chapter 2 


THE COMPONENTS 
OF SPM-11M 


The SPM-11M performance monitor consists of two main compo- 
nents: the Data Collection Component and the Data Reduction 
Component. The Data Collection Component records the resource 
usage events of the operating system to a logfile; the Data 
Reduction Component reads the logfile and produces a perfor- 
mance report suitable for analysis. 


This general architecture is depicted in Figure l. 


Data 


Reduction Performance 
Component Report 


Figure 1] 
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By decoupling the Data Collection Component from the Data 
Reduction Component in time, the performance monitor can 
collect detailed information about a huge number of events, 
albeit in a raw format. The Data Reduction Component can then 
be used to selectively analyze and filter the information in 
the logfile to produce a performance report. This architecture 
shifts the computational aspects of the performance monitor 
from the Data Collection Component to the Data Reduction 
Component. The benefit derived is that the performance monitor 
uses less CPU time, thus minimizing its interference with the 
CPU. The cost is more I/0 activity, which in most systems can 
be directed to a secondary mass storage device not in the path 
of the major stream of I/0 activity. 


2.1 DATA COLLECTION COMPONENT 
The Data Collection Component consists of both software and 
hardware distributed in various places within an RSX-11M 
system. 
The basic pieces of the Data Collection Component are: 

0) Hooks 

0 Hook Dispatcher 

0) Hook Routines 

0) Hook Records 

0) KW11-P Clock and Handler 

0) Hook Buffers 

0 Logfile 

) Data Collection Task (...COL) 

fe) Termination Task (...TRM) 


fe) COL Message Task (COLMSG) 


The relationship between these pieces is shown in Figure 2. 
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DATA COLLECTION COMPONENT 


- COL TASK 


Hook 
Routines 


PARTITION 


Hook 
Record 


Figure 2 


Heuristic Procedure for Data Collection 
At this point a heuristic procedure for data collection will be 


given, although the terms used in the procedure have not been 
precisely defined. 


1/82 THE COMPONENTS OF SPM-11M 2-3 


When a resource uSage event occurs in RSX-11M, the corre- 
sponding hook cails the hook dispatcher, which uses the hook ID 
to call the appropriate hook routine. The hook routine 
collects information relevant to the hook and assembles it into 
a hook record, which resides in a hook buffer. When a hook 
buffer is filled with hook records, it iS written to the 
logfile. The logfile is closed at the end of the measurement 
interval, and subsequently reopened by the Data Reduction 
Component. It reads the hook records and uses them to derive 
the resource usage metrics and print a performance report. 


The details of these pieces will now be developed more fully. 


Je leel Hooks 


A hook is simply an implementation technique for capturing a 
resource usage event. For SPM-11M, a hook is implemented as a 
subroutine call inserted at the point in the operating system 
where the event occurs. The subroutine call passes control and 
One argument, the hook ID, to the hook dispatcher. The form of 
an SPM-11M hook is as follows: 


CALL @$HKDSP 
~WORD H$XXXX 


where XXXX iS mnemonic identifying the particular hook. A 
complete specification of all hooks is given in Appendix A. 


Qed Hook Dispatcher 


Hooks are resident within the operating system; their method of 
insertion is addressed in Chapter 3, section 3.1.3. However, 
most of the code and database for the Data Collection Component 
is not resident within the RSX-11M executive. 


The bulk of the data collection code is resident in the data 
collection task called COL (taskname is ...COL). The chief 
benefit derived from this design is that only a small amount of 
executive space (which translates directly to the critical 
resource: pool) is used by the performance monitor. 


The purpose of the hook dispatcher is to map and call the hook 
routines which are resident in the COL task. Note that, though 
the hook routines are resident in the task partition for COL, 
they are executed in the context of a directive or interrupt 
service routine. The hook dispatcher is resident in pool, is 
allocated when COL is activated, and is deallocated when COL 
exits. The hook dispatcher is analagous to an ICB for a 
loadable driver. 
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& 


A one word dispatch vector labelled $HKDSP is added to system 
common (SYSCM). This word points to the entry point in the 
hook dispatcher resident in pool. It is the port through which 
all hooks pass control from the RSX-11M executive to the Data 
Collection Component of the performance monitor. 


Dre Lae3 Hook Routine 


A hook routine copies information which is generally scattered 
about the executive (typically in SYSCM or SYSTB) into a hook 
record which is resident in a static common or dynamic region. 
A timestamp is also recorded in the hook record. 


There are two general types of hooks: task and system. The 
task hooks collect data relevant to resources used by tasks; 
the system hooks collect data which is system-wide (e.g., % CPU 
time in user, kernel and idle). 

2.1.4 Hook Record 

The information collected at each hook is formatted into a hook 
record. The hook record provides an identical representation 
of a hook's information content both in memory and in the 
logfile. 


Each hook record contains both generic and hook-specific data. 
Generic data applies to all hooks. Generic data consists of: 


9) Hook ID 

) Taskname 

9) Timestamp 

O Task's TI (UCB address) 
Hook specific data applies to only one or a small subset of the 
hooks. For example, the H$CDRP (call directive processor) hook 


records the directive ID code as hook-specific data. 


Appendix A specifies the information content of the hook 
records. 


1/82 THE COMPONENTS OF SPM-11M 2-5 


2e1.5 KW11-P Clock and Handler 


For precise performance measurements, SPM-11M needs a high 
speed clock running independent of the RSX-11M system clock. 
It is therefore a requirement that a KW11-P clock be installed 
on a machine running SPM-11M. This KW11-P clock must be in 
addition to the RSX-11M system clock, be it a KW11-L or KW11-P. 


The KW11-P is initialized by the COL task to run at 100 kHz 
(10 microsecond ticks) and to interrupt every 65536 ticks 
(approximately every 0.65 second). 


The KW11-P clock time is maintained as as 2 word (32 bit) value 
which, at a rate of 100 kHz, will overflow in a little over 
11.5 hours. 


To preclude the possibility of overflow of the KW11-P clock 
time, a@ maximum measurement interval of 11.5 hours has been 
established. The task COL enforces this by setting an 11.5 
hour mark-time when activated. If the timer expires, COL will 
stop data collection and exit. 


The COL task allocates a piece of system pool and links it to 
the KW11-P clock vector. This pool node serves as the clock 
interrupt handler, which updates the high order clock time 
located in SYSCM at $PCLKH. The low order clock time is not 
stored in memory; rather, each hook routine copies the current 
contents of the KW11-P clock's count register to the hook 
record directly to get the low order time word. 


2.1.6 Hook Buffer 


Hook records are stored in buffers which are resident in either 
a static common or a dynamic region. When a hook buffer is 
full, the hook routine sets an event flag which signals the COL 
task to write the buffer to the logfile. 


The hook buffers are linked together into a circular list. 
There may be from 2 to 8 buffers in a list, and all the buffers 
must be of the same length. A buffer may be from 256 words to 
4096 words long. 


If the buffers are resident in a static common, the maximum 
$1ze common which can be used is 4096 words. This limitation 
is imposed because the COL task uses one APR to map the static 
common. 


If the buffers are resident in a dynamic region, the region can 
be from 512 words to 32K words long. 
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Cala Logfile 
The logfile contains four types of records: 
fe) Monitor Parameter Block (MPB) 
fe) Information Records 
0) Hook Records 
9) System Metric Records 


See Appendix E for a specification of the logfile. 


Monitor Parameter Block 


The Monitor Parameter Block (MPB) is used, by the COL task to 
initialize its measurement parameters. The MPB is formatted as 
an Information Record with record type I$MPB. A detailed 
description of the MPB is given in Appendix B. 


The MPB is generated by a command file called SMPGEN.CMD. See 
Chapter 3, section 3.2.1 for details. 
Information Records 
The Information Records are used to supplement the Hook Records 
in the logfile with system context useful to the Data Reduction 
Component. 
When COL starts up it reads the MPB from the MPB file and 
writes it to the logfile. Following the MPB, COL writes a 
stream of Information Records which contain a number of RSX-11M 
data structures defining the initial. system state. These data 
structures are: 

) Task Control Block (TCB) 

fe) Partition Control Block (PCB) 

) Device Control Block (DCB) 

a) Unit Control Block (UCB) 
Each data structure is copied to a separate Information Record. 
When COL begins a measurement interval (starts data collec- 


tion), it records the RSX-11M system time as well as the 
SPM-11M time (KW11-P time) to an Information Record (I$TMR). 
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When COL ends a measurement interval (stops data collection) it 
copies the RSX-11M system time, SPM-11M time, CPU time accrued 
in kernel state and CPU time accrued in idle state to an 
Information Record (I$STM). 


A complete specification of all Information Records is given in 
Appendix C. 


Hook Records 


As each hook point is encountered in the executive, a Hook 
Record is written to the logfile. See section 2.1.4 for 


details. 


System Metrics Record 


At the end of each sample interval, a System Metrics Record is 
written to the logfile. This record contains information which 
describes the system-wide usage of the selected resources. 


The System Metrics Record is specified in Appendix D. 


Logfile Media 


The logfile can be resident on disk as a Files-1l file or on 
magtape as a sequence of tape records. 


If the logfile is resident on disk, it consists of a sequence 
of virtual blocks (virtual block=256 words). The records 
within these virtual blocks are defined according to the record 
definitions for the MPB, Information Records, Hook Records and 
System Metric Records. Note that the logfile does not have any 
other record structure (such as FCS or RMS type records). 


If the logfile is on a magtape, the MPB, Information Records 
and Hook Records are imbedded in a stream of tape records. 
Each tape record is equal in length to a hook buffer. 


2eles Data Collection Task (...COL) 


This section gives a functional description of the COL task. A 
guide to using COL is provided in Chapter 3, section 3.2.2. 


As noted before, this task contains both code which executes in 
executive context (as a directive or interrupt process) and 
code which executes in the context of a privileged task. The 
code which executes at executive level is the hook routines. 
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Pa 


26168 el COL Executive Level Code - 


The hook routines were made a part of the COL task for a number 
of reasons: 


) They must be resident in some partition outside of 
executive space. 


9) They can easily be loaded as part of the COL task. 


0) They implement routines which are common to hooks and 
to the COL task. 


2.1.8.2 COL Task Level Code - 


Most of the COL task consists of code which is executed at task 
level. The major functions of the COL task are: 


O Initialization 

) Starting data collection 
O Writing to logfile 

0 Stopping data collection 


0) Cleanup 


2.1.8.2.1 Initialization - 


When COL begins execution, there is very little SPM-11M code 
elsewhere in the system. All that exists are the hooks in the 
executive which all call a dummy return subroutine in SYSXT. 
It is the job of COL to initialize all code and databases 
required for the SPM-11M performance monitor. The specific 
sequence of initialization functions performed by COL are: 


oO Read MPB file and store MPB in COL buffer. 


O Create dynamic region (if necessary) and set up ring 
of hook buffers. 


) Write MPB and Information Records (RSX-11M data 
structures) to logfile. 


0) Mark COL task as fixed in memory and nonshufflable. 


9) Initialize hooks specified in MPB. 
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fe) Allocate pool node for hook dispatcher and copy code 
to pool node. 


9) Allocate pool node for KW11-P clock handler and copy 
code to pool node. Link pool node to KW11-P clock 


vector. 
Oo Initialize KW11-P clock and turn it on. 
O Initialize measurement parameters as specified in MPB. 


(ape Cre ar Starting Data Collection - 


When data collection is disabled, the hook dispatch vector 
$HKDSP points to a dummy routine in SYSXT which simply steps 
over the hook ID and returns to the instruction in the 
executive following the hook. 


Just prior to starting data collection, COL writes a "start 
data collection" Information Record (I$TMR) to the hook buffer. 


To enable data collection the COL task simply points the hook 
dispatch vector $HKDSP to the hook dispatcher code resident in 
pool. 


Cel 8 ete3 Writing Hook Records to Logfile - 


The steady state function of the COL task is to write Hook 
Records to the logfile. When a hook routine fills a hook 
buffer, it sets an event flag for COL which wakes COL from its 
wait state. COL then writes the hook buffer to disk or magtape 
(waiting for completion of the write), and loops to see if 
another hook buffer is ready to write. When no more hook 
buffers are outstanding, COL returns to the wait state. 


If the hook buffers fill up too rapidly for COL to write them 
to the logfile, COL will set the overflow status bit. If the 
overflow status is set when a measurement interval expires, COL 
will print a status message on the console device (CO:). In 
general, the data collected during a measurement interval 
should not be used for data reduction if the overflow condition 
occurred. 


2.1.8.2.4 Stopping Data Collection - 


To stop data collection, COL merely points the hook dispatch 
vector $HKDSP to the dummy routine at $HKEXT in SYSXT. It then 
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writes a stop data collection Information Record (I$STM) to the 
hook buffer. Any outstanding records in the hook buffer will 
be written to the logfile. 


Cel we 2 o0 Cleanup - 


Before COL exits, it must release any system resources it has 
allocated and deactivate any hardware it has turned on. The 
following actions are thus performed: 


) Turn off KW11-P clock. 


0 Deallocate pool nodes for hook dispatcher and KW11-P 
clock handler. 


(a) Unfix COL task. 


2n129 Termination Task (...TRM) 


The purpose of the termination task (...TRM) is to signal the 
COL task to stop data collection and exit. TRM provides a way 
to manually terminate the COL task, as opposed to automatic 
shutoff by timeout or buffers (see Chapter 3, section 3.2.1). 


(om eee ae) COL Message Task (COLMSG) 


The COL message task contains the ASCII text for the error 
messages issued by the COL task. If the COLMSG task is instal- 
led and a COL error occurs, the full error message text will be 
printed. If a COL error occurs and the COLMSG task is not 
installed, the COL task will print an error number which can be 
correlated with the correct error message in Chapter 3, section 
Si tue x 


Ce DATA REDUCTION COMPONENT 

The main purpose of the Data Reduction Component is to read the 
raw data from the logfile (hook records) and produce a perfor- 
mance report detailing the resources used by the various tasks 


in the system. 


The Data Reduction Component accomplishes this in a multi-step 
process involving two tasks: 


O Monitor Data Reduction (MDR) Task 


fe) DRS Task 
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There are three major steps in the data reduction process: 
1. Map Hook Records to Task Workload Records and generate 
system-wide metrics section of performance report (MDR 
Pass 1). 
2. Sort Task Workload Records (DRS). 
3. Summarize Task Workload Records and generate task 
metrics section of performance report (MDR Pass 2). 


The Task Workload Records are intermediate data structures 
which contain the data collected for each task and each 
resource used by the task. 


This general procedure is depicted in Figure 3. 


DATA REDUCTION COMPONENT 


TRACE.LOG 
Hook 
RESOURCE. TMP RESOURCE. SRT 
mone canes 
i Performance 
RESOURCE. SRT —— Report 


Figure 3 


RESOURCE. TMP 


Task Workload 
Record 
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From the figure we see there are four databases which are 
processed by the two tasks: 


fo) TRACE.LOG (logfile containing Hook Records). 


fe) RESOURCE.TMP (intermediate file containing unsorted 
Task Workload Records). 


0) RESOURCE.SRT (intermediate file containing sorted Task 
Workload Records. 


) REDUCE.RPT (final performance report). 


Zila k MDR Pass 1 


MDR reads hook records from the logfile (default name is 
TRACE.LOG) and maps the information to the Task Workload 
Records in the intermediate file RESOURCE.TMP. 


Cele2 DRS Pass 


DRS sorts the Task Workload Records using the following three 
keys: 


() Generic Taskname 
fe) Task's TI UCB address 


0) Task start time. 


NOTE: By “generic taskname" we mean the installed taskname of 
a multiuser task. For example, the generic taskname for 
the task PIPT5 is ...PIP. If the task is not multiuser, 
generic taskname is simply the run time taskname. 


The three keys listed above are concatenated into one "big" 
key, with the generic taskname forming the highest order part 
of the key, the Task's TI UCB address forming the middle order 
part of the key, and the Task start time forming the low order 
part of the key. The DRS task sorts all the Task Workload 
Records using this one big key. With this technique the DRS 
task only needs to do one sort operation on the _ file 
RESOURCE. TMP: 
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When DRS is done sorting the Task Workload Records, the records 
will be arranged as follows: 


0 All records with the same generic taskname will be 
clustered together. 


re) Within a generic taskname cluster, all records with 
the same TI will be clustered together. 


0 All records within a taskname-TI cluster will be 
sequenced by ascending task start time. 


DRS writes the sorted Task Workload Records to the file 
RESOURCE.SRT. 


2aee3 MDR Pass 2 


MDR reads the Task Workload Records from RESOURCE.SRT and 
generates a performance report. A description of the 
performance report is given in Chapter 5. 
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Chapter 3 


GUIDE TO USING SPM-11M 


3.1 INSTALLATION 


cee are SPM-11M Kit 


The SPM-11M kit is distributed on 800 BPI magtape. It contains 
all the files necessary to install and use SPM-11M. The files 
are in DOS tape format. When copied to disk, the files will 
occupy approximately 900 disk blocks. 


The command file PMONCPY.CMD can be used to copy the kit files 
from tape to tape, tape to disk, disk to tape or disk to disk. 
All files are contained in the directory [11,2]. The contents 
of the kit are: 


Component File 

Kit copy command file PMONCPY.CMD 
SPM-11M mini-reference guide: SPM.DOC 

MPB GEN command file SMPGEN.CMD 
Macro definition prefix file HKMAC .MAC 
Executive source correction command file PMONSLP.CMD 
Executive source correction files *.COR 
FIIACP patch command file PMONPAT.CMD 
FLIACP patch source FIOSUB.PAT 
COL/TRM build command file PMONBLD.CMD 
COL overlay descriptor file COLBLD.ODL 
COL/TRM object library COL.OLB 

MDR object library (EIS version) MDREIS.OLB 
MDR object library (FPP version) MDRFPP.OLB 
MDR/CLF build command file MDRTKB.CMD 
Data reduction sort task DRS.TSK 

DRS map file DRS .MAP 

DRS sort command file DRS.CMD 

CLF task CLF.TSK 

CLF map file CLF .MAP 

OVL object library OVL.OLB 

OVL task OVL.TSK 

OVL map file OVL.MAP 
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Prerequisites to Installing SPM-11M 


COL Prerequisites 


The following are the prerequisites for running the COL task: 


6) 


Mapped System 


SPM-11M can only be installed on a mapped RSX-11M 
system. 


Get Partition Parameters Directive 
The COL task will only work if support for the Get 


Partition Parameters (GPRT$) directive is generated 
into the executive. 


AST Support 


The COL task will collect System Metrics only if AST 
Support is generated into the executive. 


Send and Receive 


The COL task will issue full ASCII error message text 
via the error message task COLMSG if support for Send 
and Receive is generated into the executive. 


PLAS Support 


If PLAS support is not generated into the executive, 
the COL task buffering is limited to a maximum of a 4K 
word static common. 


If PLAS support is generated into the executive, the 
COL task buffering may be in a dynamic region up to 
32K words long. 


MDR Prerequisites 


MDR requires the following features of the system where it is 


run: 
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EIS instructions 


support for the executive directives: ASTX$, EXTK$, 
GPRT$, GTSK$. 


checkpointing to a dynamically allocated system 
checkpoint file. 
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Seles Installing SPM-11M 
To install SPM-11M, you must start with: 
0 An RSX-11M V4.0 distribution kit 
fe) An RSX-11M autopatch kit at the current level (if any) 
fe) An SPM-11M distribution kit 
To install SPM-11M you must perform an RSX-11M SYSGEN. A 
SYSGEN is required because source code for SPM-11M is inserted 


into the RSX-11M sources. SPM-11M source code is added to the 
following RSX-11M source modules: 


SPM-11M Function RSX-11M Modules 

SPM-11M Macros and Definitions RSXMCO,RSXMC 

Hooks DRDSP ,DRQIO ,DREIF ,DREXP, 
DRSUB ,REQSB ,SYSXT ,IOSUB, 
LOADR 

Additional Stack Space LOWCR 

Common Database SYSCM 

Dummy Hook Return Routine SYSXT 


The SPM-11M installation procedure consists of the following 
steps: 


fc) Copy RSX-11M V4.0 kit to baseline disk. 

fo) Perform autopatch to current level (if any). 

O Assign SY: to the baseline disk. 

O Choose a directory to which you want the SPM-11M kit 


files copied. This will be your SPM-11M~ kit 
directory. 
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0 Assuming the SPM-11M directory is [g,m] 
>SET /UIC=[g,m] 
SUPE SY bgm] 
>FLX =ddn:L11,2]PMONCPY.CMD 
>@PMONCPY 


APPLY CORRECTIONS TO EXECUTIVE SOURCES? Y 


° 


APPLY PATCH TO F11ACP DISPATCHER MODULE (FIOSUB)? Y 
@<EOF> 
>@L£200 ,200]SYSGEN 
>@[200 ,200]SYSGEN2 
NOTE: If the patch to FI11ACP fails (checksum error), 
SPM-11M will only calculate service times for 
FI1ACP. If the patch succeeds, SPM-11M will 
generate usage, wait and service times. 
If PLAS is not generated into the executive, 
create a static common up to 4K words long with 
VMR to provide space for the COL buffers. 
If you do not elect to correct the executive 
sources or patch FIl1ACP via PMONCPY.CMD you can 
do so later via the command files: 
1) @PMONSLP for executive source corrections 
2) @PMONPAT for F11ACP patch 
0) When the SYSGEN completes, perform the following 
steps: 


>SET /UIC=[g,m] 


>@PMONBLD 
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NOTE: Be sure to taskbuild COL using the baseline 


Kibrary- EL lellSYSLIB. OLB (without ANS or bag 
buffering FCS routines). Otherwise COL will be 
greater than 4096 words and will not be able to 
map its buffers via APR6. 


The command file will pause if you desire to 
edit the build files for CLF, OVL, or MDR. This 
will allow modifications to defaults for these 
programs. Instructions are included in the 
build files. 


You can build the MDR, OVL, or CLF tasks 
separately from PMONBLD.CMD by invoking the 
command file MDRTKB.CMD. 


On systems with an FP11 the file MDREIS.OLB is 
not needed and may be deleted. On systems 
without an FPP, the file MDRFPP.OLB is not 
needed and may be deleted. The file may be 
deleted before starting the SYSGEN. 


You are now ready to run @SMPGEN to generate an MPB 
and run COL. This procedure is described in the next 
section. 
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sae OPERATION 


Beek Generating the Monitor Parameter Block (MPB) 


The MPB is the structure which contains the measurement 
parameters. 


To create an MPB you invoke the command file SMPGEN.CMD. 
See Appendix G for an example SMPGEN. 
The procedure is as follows: 
>SET /UIC=[g,m] 
>@SMPGEN | 
where [g,m] is your SPM-11M kit directory. 


The MPB is created in the following way: SMPGEN creates a 
source file (default filespec is TRACE.PAR), assembles and 
builds the code in the file to produce a binary MPB file 
(default filespec is TRACE.MPB). It is this file which is read 
by the data collection task COL to initialize the measurement 
parameters. 


In addition to the files mentioned above, SMPGEN also will 
output, if requested, a saved answer file (default filespec is 
TRACE.CMD). This file can be input to another run of SMPGEN 
and will initialize the symbol table to the values of the 
variables saved in the file. 


SMPGEN is driven from a menu of parameter categories. To 
display the menu, type an <ESC>. The menu appears as: 


LEGAL PARAMETER CATEGORIES ARE : 
HOOK TASK MODE LABEL 
BUFFER DEVICE SYSTEM DONE 


wo we we we we 
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The parameter categories can be specified in any order. If a 
parameter category is not specified, the parameters will 
receive default values from either: 

0 The saved answer file, if one is specified. 


) The table of default parameters. 


Table of Default Parameters 


HOOKS - all hooks enabled, excepting Load Overlay, 
Call Directive Processor, and User 
Information. 


BUFFERS - DYNAMIC region named TRCPAR created in 
partition GEN, 2 buffers with 8 blocks per 


buffer. 
TASKS - All tasks enabled for data collection. 
DEVICES - All devices enabled for data collection. 
MODE - MANUAL mode. 
SYSTEM - System Metrics enabled with 60 = £sSecond 


sampling interval. 


LABEL - No label. 


To select a parameter category, enter the name of the parameter 
category desired as shown in the following example: 


ENTER PARAMETER CATEGORY? HOOK 


Once a parameter category is selected, the detailed parameters 
are specified. Each parameter category has a menu of responses 
which are possible for that parameter category. To get the 
menu, type <ESC>. When you are finished entering parameters, 
type "DONE". 
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A detailed description of each parameter category follows. 
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Label Field 
To select the label parameter category, type: LABEL 
The following query will be displayed: 

ENTER MPB LABEL? 


The response may be any string from 0 to 63 characters 
long. This user-definable string is stored in the MPB 
and will typically contain notes and comments appli- 
cable to a particular measurement run. It is printed 
as part of the heading on each page of the performance 
report. 


Hooks 
To select the hooks parameter category, type: HOOK 


The hooks determine which resource usage events are 
recorded to the logfile. 


You do not select each hook individually. Rather, you 
select one or more groups of hooks. Each group of 
hooks contains the subset of hooks which will generate 
a consistent set of data for measuring the usage of a 
particular resource. Hooks may be chosen from the 
following groups: 


- CPU USAGE HOOKS 

This hook group measures task CPU usage. 

It is required for all metrics for task CPU usage. 
- MEMORY USAGE HOOKS 

This hook group measures task memory usage. 


It is required for all metrics for task memory 
usage and % resident time. 


- 1/0 DEVICE USAGE HOOKS 
This hook group measures task usage of I/0 devices 
and the file system. The file system is regarded 


as any ACP which manages a device. Examples are 
FI1ACP and MTAACP. 
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This hook group is required for all metrics 
relative to task usage of I/0 devices or the file 
system. 


LOAD OVERLAY HOOK 


This hook records the relative block number of a 
task's overlay to the logfile. 


CALL DIRECTIVE PROCESSOR HOOK 


This hook records the directive ID of a directive 
to the logfile. 


USER INFORMATION HOOK 
This hook is invoked when a task issues a QIO to 
the QP: pseudo device. The I/0 Function Code, LUN, 


and six parameters Pl - P6 are written to the 
logfile. 
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Buffers 


To select the buffers parameter category, type: 
BUFFER. 


The hook buffers may be resident in either a static 
common or a dynamic region. The buffer type is 
specified by: 

ENTER BUFFER TYPE? 


The response may be either STATIC indicating a static 
common or DYNAMIC indicating a dynamic region. 


NOTE: If "STATIC" is selected, the COL task must have 
been linked to a static common in the instal- 
lation phase (see Chapter 3, section 3.1.3). 


If "DYNAMIC" is selected, COL must not be linked 
to the static common. 


If the buffer type is DYNAMIC, the name of the 
system-controlled partition in which to create the 
dynamic region is specified by: 

ENTER NAME OF BUFFER MAIN (SYS) PARTITION? 
The name of the buffer common/region is specified by: 


ENTER NAME OF BUFFER COMMON/REGION? 


The partition will be divided up into a number of hook 


buffers, determined by: 


ENTER NUMBER OF BUFFERS- [2.28% 12.4? 
Note that from 2 to 8 buffers may be specified. 
Finally, the length of each buffer is specified by: 
ENTER BUFFER SIZE IN 512 B BLOCKS? 


A buffer can be from 1 to 16 blocks long; in other 
words, from 256 words to 4096 words long. 


If a static common is used for buffering, the total 
space required for buffers must fit into the common. 
If a dynamic region is used, COL will create a region 
large enough to contain the buffers. 
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Tasks 
SPM-11M can be set up to collect data for specific 
tasks. For example, there may be some tasks whose 
performance metrics are not desired at all. 
Typically, system "“service" tasks, such as FI11ACP, 
~-e-MCR and QMG... fall into this category. 
To select the task parameter category, type: TASK. 
The following query will appear: 

DO YOU WANT TO TRACE ALL TASKS? 


If your answer is N, you will be given two choices for 
selecting the tasks for data collection: 


- Specify the tasks not to trace. 
- Specify the tasks to trace. 
The choice is made from the query: 
DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? 
If the answer is Y, you are prompted with: 
ENTER NAME OF TASK NOT TO TRACE? 
If the answer is N, you are prompted with: 
ENTER NAME OF TASK TO TRACE? 
You then type, one per line, the names of the tasks 
desired or not desired. Each taskname is from 1 to 6 
characters long. To terminate the list of tasks, type 


<CR> 


Up to 64 tasknames can be specified. 


Devices 


To get the devices parameter category, type: DEVICE. 
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SPM-11M can be set up to collect data for specific 
classes of devices. If you want to collect data only 
for selected classes of devices, answer N to the 
following query: 

DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? 
A device in RSX-11M may fall into one of four classes 
depending on the bit setting of the "Device Character- 
istics Word" U.CW1l in the UCB. 
- Directory Device (DV.DIR) 
- Sequential Device (DV.SQD) 
- Terminal Device (DV.TTY) 
- All Other Devices 


To enable data collection for a device class, answer Y 
to the query for that device class. The queries are: 


TRACE DISK (DIRECTORY DEVICE) I/0 ACTIVITY? 
TRACE TAPE (SEQUENTIAL DEVICE) I/0 ACTIVITY? 
TRACE TERMINAL I/O ACTIVITY? 


TRACE ALL OTHER DEVICES I/0 ACTIVITY? 


Mode 

To select the mode parameter category, type: MODE. 

The performance monitor can be set up to collect data 
in three different modes. You select the mode by 
answering: 


ENTER MODE? 


The possible modes are: MANUAL, AUTOSTOP and REPEAT. 
Each mode determines the manner in which a measurement 
interval begins and ends. A description of each mode 
follows: 


- Manual 
In manual mode, a measurement interval begins when 


the COL task is invoked and ends when the TRM 
(termination) task is run. 
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Autostop 

In autostop mode, a measurement interval begins 
when the COL task is invoked and ends when either 
of the following two events occur: 


A mark-time expires. 


- A predetermined number of buffers have been 
filled. 


You determine the type of autostop by responding 
to: 


ENTER SAMPLING TYPE? 


“with either TIME or BUFFER. 


If TIME is specified, you then have to specify the 
timeout interval: 


ENTER SAMPLING INTERVAL TIME UNIT [D :MIN] 
ENTER SAMPLING -INTERVAL IN units ? 


where "units" is the time unit specified in the 
previous query. Legal units are SEC, MIN or HR. 


NOTE: Do not confuse this sampling interval with 


the system metrics sampling interval 
described in the next section. 


If BUFFER is specified as the interval type, you 
must specify the number of buffers per sample: 
ENTER NUMBER OF BUFFERS PER SAMPLE? 


Note that each buffer is from 1 to 16 disk blocks 
(256 words) long. 


Repeat 

Repeat mode is autostop mode repeated a number of 
times. The sampling interval is specified as for 
autostop mode. In addition, you must specify: 


- The number of intervals 


- The length of time between intervals. 


GUIDE TO USING SPM-11M 3-13 


You specify these parameters by answering the 
following queries: 


ENTER MAX. NUMBER OF SAMPLES? 
ENTER INTERVAL BETWEEN SAMPLES TIME UNIT [LD :MIN4? 
ENTER INTERVAL BETWEEN SAMPLES IN units ? 
where "units" is the time unit specified in the 
previous query. 

0) System 


To select the system-metrics parameter group, type 
"STS TEM sg 


If you want the system metrics, answer Y to the next 
query: 


DO YOU WANT THE SYSTEM METRICS? [Y/N]: 


If you answered Y, you must then specify the sampling 
interval by: 


ENTER SYSTEM METRICS SAMPLING INTERVAL (SEC): 2 


re) Done 


When you are finished entering parameters, type 
"DONE". The SMPGEN procedure will then create: 


- A monitor parameter block (MPB) file 
(filename.MPB). 


- A parameter source file (filename.PAR). 


- A saved answer file (filename.CMD, if specified). 


Note: SMPGEN will prompt you for the parameter source 
file and saved answer file, and you must enter 
a valid file specification. 
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S262 Using COL 


The COL task is used to initialize the performance monitor, 
start data collection, collect data, stop data collection and 
clean up the performance monitor before exiting. 


Installing COL 


The COL task can be installed in any partition. If possible, 
create a separate 4K word partition for COL. If installed in a 
System-controlled partition, COL will automatically fix itself 
and mark itself as non-shufflable. It is therefore desirable 
to install and run COL when there is little or no system 
activity in the partition in which COL is installed so as to 
load COL in the lower end of the partition and reduce fragmen- 
tation of the partition. The COL task will occupy approxi- 
mately 4K words of memory. 

COL is taskbuilt with a default priority of 230. Note that COL 
has a higher priority than F11ACP and ...MCR, but a lower pri- 
ority than ...LDR. It is highly recommended that the priority 
of COL not be altered to a value lower than the default value 
of 230, otherwise excessive overflows may occur which will 
invalidate the measurement runs. 


If full ASCII message text output is desired, install the 
COLMSG task. 


If you are using a static common for COL buffers, be sure to 
install it before installing the COL task. 


Install COL and COLMSG by: 
>INS TRCPAR ;ONLY FOR STATIC COMMON 
>INS COL 


>INS COLMSG 


Running COL 
To run COL, type a command line of the form: 
>COL logfile/sw=MPBfile/sw 


The default logfile specification is SY:[cur uic]TRACE.LOG. 
The default MPBfile specification is SY:[cur uic]TRACE.MPB. 
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Stopping COL 


There are two ways to terminate COL: 


0) 


fe) 


RUN TRM 


Specify AUTOSTOP or REPEAT mode in SMPGEN. 


RUN TRM will terminate COL regardless of the mode in which COL 
is running: MANUAL, AUTOSTOP or REPEAT. 


COL will 


also terminate if any of the following abnormal 


conditions are detected: 


0) 
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Powerfail recovery 

In this case, if  powerfail recovery support’ is 
included in the executive, COL will issue a SPRA$ 
directive. Upon powerfail recovery, COL will simply 
exit. 

Write errors 

If COL detects write errors, it will print a message 
and exit. Write errors will generally corrupt the 
logfile with invalid data. 


Automatic 11.5-hour termination. 
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COL Switches 


Switch defaults -- 


Output: SY¥:sTRACE.LOG/DENS :800/EX% :100./1F :100.,/WI 210. 
Input: SY :TRACE.MPB/DL :0/DV :LBO/PR :GEN 


Output Switches Description 


Append records to end of magtape. COL will 
space over all existing files on the magtape 
and append the records for this run starting 
at the current end-of-volume point. 


/DENS :density Set tape density to 800 or 1600 bpi. 
Densities cannot be mixed on a single tape 
volume. 


/EX in Specifies disk file extent size in 256W 
blocks. 


/1F in Specifies disk file initial size in 256W 
blocks. 


{Wisin Specifies number of retrieval pointers in 
window block. 


/BF :min Number of buffers = m ; size of buffer = n 
256W blocks. This switch overrides the 
buffering specification in the MPB. 


/DL in Number of MINUTES COL delays before it 
| Starts data collection, 

/DV :ddnn Device selected for system metrics. 

/PR :parnam Partition selected for system metrics. 

/Ti inn Collect data only for tasks with TI of TTnn. 
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Example 1 
>COL DB2:[3,300]CPUTEST/IF :1000/EX :200=DB1 :[5,200]PARM1/DV :DB2: 


logfile is DB2:[3,300jCPUTEST.LOG with initial size 1000 and 
extent size 200. 


MPB file is DB1:[5,200]PARM1.MPB with system metrics specified 
for DB2. 


Example 2 
>COL MM1 :/DENS :1600=DB1 :[5,200}SAMPLE.MPB 


& 
logfile is_on MM1: in 1600 BPI; MPB file is 
DB1:[5,200]SAMPLE.MPB. 


Example 3 
>COL = 


logfile is SY:[current uic]JTRACE.LOG; MPB file is SY:[current 
uic{TRACE.MPB. 


NOTE: You cannot run COL with a null command line, i.e, COL 
<CR>. The COL task expects to see explicit filespecs or a 
bare "=" indicating defaults on both input and output. More- 
over, you cannot invoke COL with a command of the form: 


>RUN COL 


since no filespecs can be specified with this form. One final 
thought in this regard: only one copy of COL can be active in 
the system at a time. If multiple invocations of COL are 
attempted at different terminals, all but the first will be 
rejected with an error message “MONITORING ACTIVITY IN 
PROGRESS". 


Once COL is activated, it will run in the mode specified in the 
MPB but always for a maximum of 11.5 hours. This time limit is 
imposed because the KW11-P clock time will overflow in a little 
over 11.5 hours. 
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COL Messages 


COL outputs two types of messages: error messages and status 
messages. 


Full ASCII error message text will be printed only if the 
COLMSG task is installed. If the COLMSG task is not installed, 
COL will print a message of the form "COL ERROR XXXXXX", where 
XXXXXX is the error number. The error messages are listed by 
error number in the following list. Error messages are issued 
if an error condition occurs while COL is starting up and 
initializing the performance monitor. Error messages are 
output to the terminal of issue (TI:) for COL. 


Status messages are issued while COL iS running in steady 
state. There are status messages for both normal and error 
conditions. Status messages are issued to the console terminal 
(CO:). The COLMSG task does not have to be installed to get 
the status messages; as they are printed directly by the COL 
task. 


COL Error Messages 


000000 COLMSG ~--. XXXXXX (DSW) GET COMMAND LINE ERROR 


Explanation: A "Get MCR Command Line" directive failure 
occurred, 


User Action: Reenter COL command line using correct 
form. 
NOTE: Illegal command forms are: 


Lae POOL KOR> 


2. >RUN $COL <CR> 


Legal command line forms are: 


1. >COL filespec/sw filespec/sw 


2. COL filespec/sw 


/SW 
3. >COL =filespec/sw 
4.  >COL = 
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COLMSG -- COMMAND SYNTAX ERROR 

Explanation: Entered incorrect syntax for command line. 
User Action: Reenter command line with correct syntax. 
COLMSG -- MPB FILENAME SYNTAX ERROR 

Explanation: Entered incorrect syntax for MPB filename. 
User Action: Reenter MPB filename using correct syntax. 
COLMSG -- XXXXXX (FCS) MPB FILE ACCESS FAILURE 
Explanation: COL failed to open MPB file or received a 
read error when attempting to read the MPB file. The 
code XXXXXX (FCS) indicates the FCS error code returned 
uot ome 0 6) er 

User Action: Check that specified MPB file exists, the 
volume is mounted (if disk), or that the file protection 
does not prevent COL from reading the MPB. 

COLMSG -- XXXXXX (DSW) ASSIGN LUN FAILURE 


Explanation: COL failed to assign a LUN to the logfile 
device. 


User Action: Check that the device specified for 
logfile is in the system configuration. 


COLMSG -- ILLEGAL LOGFILE DEVICE TYPE 

Explanation: The device specified for the logfile is 
not of the correct type. Valid logfile device types 
are: Directory structured (disk, DECTAPE), or Sequential 
(magtape). 


User Action: Specify a device which is either directory 
structured or sequential. 


COLMSG -- LOG FILENAME SYNTAX ERROR 
Explanation: Entered incorrect syntax for logfile. 


User Action: Reenter logfile specification using 
correct syntax. 


COLMSG -- XXXXXX (FCS) LOGFILE ACCESS FAILURE 


Explanation: COL failed to open the logfile. The code 
XXXXXX (FCS) is the FCS error returned to COL. 
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User Action: Check that the logfile volume is mounted 
and the necessary directory exists (if disk), or the 
volume is online (if magtape). 


COLMSG -- ILLEGAL BUFFER SPECIFIED 


Explanation: The parameters specified by the /BF :n :m 
switch were not valid. Either the number of buffers (n) 
was out of range (<2 or >8) or the buffer size was out 
of range (>16). 


User Action: Respecify a valid buffer count or size via 
the /BF switch. 


COLMSG -- XXXXXX (DSW) BUFFER PARTITION NOT IN SYSTEM 


Explanation: The partition specified in the MPB is not 
in the system. 


User Action: If the buffer partition is a static 
common, check that the static common partition exists 
and that the common is installed. 


COLMSG -- BUFFERS WILL NOT FIT INTO PARTITION 


Explanation: The number of buffer blocks specified in 
the MPB (NUMBER OF BUFFERS * BUFFER SIZE IN 512 B 
BLOCKS) is greater than the number of 512 B blocks in 
the physical buffer partition. 


User Action: Use /BF :m:n or do a SMPGEN and specify the 
NUMBER OF BUFFERS and BUFFER SIZE IN 512 B BLOCKS such 
that the product of the two is less than or equal to the 
number of 512 B blocks in the physical buffer partition. 


COLMSG -- XXXXXX (DSW) CANNOT CREATE BUFFER PARTITION OR 
ADDRESS WINDOW 


Explanation: COL received a DSW error when attempting 
to create the dynamic buffer partition specified in the 
MPB, or when attempting to create an address window to 
map the dynamic partition. The error XXXXXX (DSW) is 
the DSW error from the Create Region directive or from 
the Create Address Window directive. 


User Action: Check that enough space exists in the GEN 
partition to contain a dynamic region with the size 
specified in the MPB. 


If the error was from a Create Address Window directive, 
check the size of the COL task (look at the map in 
[11,2]COL.MAP) and verify that it is less than or equal 
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to 4096 words. If COL is greater than 4096 words, it 
may have been taskbuilt using a SYSLIB.OLB with ANSI or 
big buffering FCS routines. COL must then be 
re-taskbuilt using a baseline SYSLIB.OLB which contains 
the non-ANSI FCS routines. 


COLMSG -- MONITORING ACTIVITY IN PROGRESS 


Explanation: A multiple invocation of the COL task was 
attempted. Only one copy of COL can be active at a 
time. 


User Action: Do not attempt to run more than one copy 
of COL at a time. 


COLMSG -- INVALID MPB FILE 


Explanation: The MPB filespec specified in the COL 
command line is not the name of a valid MPB file. 


User Action: Reenter a filespec for a valid MPB file. 
COLMSG -- INFORMATION RECORD ALLOCATION FAILURE 


Explanation: Insufficient space exists in the buffer 
partition to contain all the Information Records. 


User Action: Do a SMPGEN and specify enough blocks 
(NUMBER OF BUFFERS * BUFFER SIZE IN 512 B BLOCKS) to 
contain all the Information Records. The space required 
is roughly that needed to contain the largest of the 
following three system lists: 1)TCBs, 2)PCBs, and 
3)DCBs-UCBs. 


COLMSG -- KW11-P VECTOR OR CSR UNAVAILABLE 


Explanation: Either the KW11-P vector is in use, or the 
KW11-P CSR is non-existent on the UNIBUS. 


User Action: Check that the correct KW11-P vector and 
CSR were specified in the procedure @PMONBLD.CMD, that 
the vector is not used by another RSX-11M driver or 
task, and that the CSR is addressable on the UNIBUS. 


COLMSG -- CANNOT USE SYSTEM'S KW11-P as SPM-11M CLOCK 


Explanation: The RSX-11M system clock is a KW11-P and 
an attempt was made to use it as the SPM-11M 
(performance monitor) clock. 


User Action: Check that a separate KW11-P was installed 
for use by the SPM-11M software, and that the vector and 
CSR specified in the procedure @PMONBLD.CMD was for this 
clock. 
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COLMSG -- POOL NODE ALLOCATION FAILURE 


Explanation: COL could not allocate a RSX-11M pool 
node. 


User Action: Re-run COL when sufficient pool is 
available. 


COLMSG -- BUFFER OVERFLOW 


Explanation: COL failed to allocate space for a hook 
record because all buffers were full. 


User Action: Re-run COL, using a larger buffer size 
specified either via SMPGEN.CMD or the /BF switch. 


COLMSG -- PARTITION SPECTEIED. NOT IN. SYSTEM 


Explanation: The partition specified via the /PR switch 
is not configured in the system. 


User Action: Respecify a partition configured in the 
system. 

COLMSG --. ILLEGAL DELAY VALUE SPECIFIED 

Explanation: An illegal delay value has been specified 


via the /DL switch. 


User Action: Re-specify a delay value in the correct 
range (0 to 1440). 


COLMSG -- COL NOT TASKBUILT FOR REGION TYPE SPECIFIED IN 
MPB 


Explanation: The COL task was taskbuilt to use a 
certain region type (DYNAMIC or STATIC), but the other 
type (STATIC or DYNAMIC) was specified in the MPB. 


User Action: If you taskbuilt COL to use DYNAMIC 
regions, specify only DYNAMIC regions when creating a 
parameter file with SMPGEN; if you taskbuilt COL to use 
STATIC regions, specify only STATIC regions’ when 
creating a parameter file with SMPGEN. 
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PERFORMANCE MONITOR INITIALIZED 


Explanation: COL has successfully initialized and is 
now ready to collect data. 


User Action: None 

PERFORMANCE MONITOR EXITING 

Explanation: COL has stopped data collection and has 
cleaned up its databases. This status message is issued 
by COL immediately prior to exiting. 

User Action: None 


CANNOT MAP OUTPUT BUFFER 


Explanation: COL received an error when attempting to 
map to the output buffer using the Map directive. 


User Action: Check that the dynamic region used as the 
output buffer was successfully created. 


LOGFILE WRITE ERROR 


Explanation: COL received an FCS or QIO error when 
attempting to write to the logfile. 


User Action: Check the integrity of the logfile. if 
repeated errors occur to the same logfile, rerun COL to 
create a new disk file or mount a fresh tape. 


LOGFILE CLOSE ERROR 

Explanation: COL received an error when attempting to 
close the logfile. COL will exit shortly after printing 
this message with the logfile improperly closed. 

User Action: Because the logfile was improperly closed, 


it may be difficult to read the logfile and produce a 
performance report. 
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BUFFER OVERFLOW 


Explanation: Hook records were written to the hook 
buffer faster than COL could write them to the logfile. 


User Action: In general, the data collected during a 
measurement interval which overflowed is not usable by 
the MDR task to produce a performance report. An 
attempt should be made to rerun the measurement to 
obtain data without overflow. Prior to attempting 
another measurement run, a SMPGEN should be run with 
larger buffers specified than for the measurement run 
which overflowed. 


Using TRM 


The TRM task is used to manually signal the COL task to stop 
data collection, cleanup and exit. TRM will cause COL to exit, 
regardless of the mode in which COL was running: manual, 
autostop or repeat. 


TRM is run by the command >RUN TRM. 
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3.2.4 Using MDR 


MDR is used to read the logfile and produce a performance 
report. MDR is used in conjunction with DRS (sorting) task to 
produce the performance report. The general procedure is as 
follows: 


0) >INS DRS 
>RUN MDR 
MDR>LISTFILE/sw=LOGFILE/sw 


MDR will read the command line and execute pass 1. 
MDR will then attempt to spawn the task DRS. If MDR 
detects an error in the spawn, or MDR has been built 
to prevent automatic spawn, the DRS pass must be 
executed manually. In this case, MDR will print the 
following message and suspend: 


MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY 
USING DRS.TSK 


MDR -- 
>DRS RESOURCE.SRT=RESOURCE.TMP/FO :V :156/KE :1.12/PR :T 


MDR -- AFTER THE SORT HAS COMPLETED, RESUME THIS TASK 
(...MDR) 


NOTE: Rather than type the command line to DRS as shown 
above, you can simply invoke the command file @DRS. 


0) >@DRS sorts the intermediate file. 
0 >RES MDR 
MDR executes pass 2 and prints the performance report. 


fo) MDR>AZ 


Certain MDR command switches restrict the input data which will 
be processed. If a logfile contains too much activity for MDR 
to reduce the data without running out of space, these switches 
(/AF, /BF, /-MD, /NT, /NU, /TS, /UC) may be used to reduce a 
logfile by successive runs of MDR, analyzing only parts of the 
workload in each run. 


When using the switches /NT, /NU, /TS, or /UC, MDR will prompt 
for the task or device names after the command line is 
processed. The tasknames are specified as 1 to 6 RAD50 
characters per entry. Only generic tasknames are used for /NT 


or /TS. The TI device names are entered as "DDnn:", with one 
entry per line. 
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MDR Switches 
Switch defaults -- 


OULDUT Ss SY SREDUCE.RPTZSP 
input: SY:TRACE.LOG/DM :2/LI :2/RW/SI :613/MD/SK :0/DE :800/-IC/-SC 


Output Switches Description 


/SP /-SP SPool output file 


Input Switches 


/AF :PChigh :PClow! Only process records from AFter specified 
time : 


/BF :PChigh:PClow| Only process records from BeFore specified | 
time 


/DE :nnnn Select input magtape DEnsity, 800 or 1600 
(ignored unless /RW is also used) 


/DM:nnn DuMp specified record types, nnn is total 
of desired types: 


001 - buffer headers 

002 - unknown record types 

004 - system configuration info records 

010 - task event hook records 

020 - system metric records 

040 - user information hook records 

100 - load overlay hook records 

200 - call directive processor hook records 


/1C /-1C Replace the % resource column of the report 
with a count of incomplete intervals. 


/LI inn Detail level of task workload metrics: 


00 - no report produced 
Ql - system-wide summary only 
O02 - system and task Summaries 
03 - system, task, and TI: summaries 
04 - all summaries and each complete 
task run 
05 - all summaries and all task invocations 


(continued on next page) 
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MDR Switches (continued) 


Input Switches Description 

/MD /-MD Report on tasks with missing data 

/NT * Do Not process hooks for listed Tasks 

/NU * Do Not process hooks for listed devices as 
Pe3 

/SC /-SC Produce System Configuration section of 
report 

/ST inn Selects the contents of Sampling Interval 


report by setting nn to the total for the 
desired items: 


000 - no report produced 

001 - data collection start/stop times 

002 - % CPU usage 

004 - % memory partition usage 

010 - 4 device time busy 

020 - % device space used 

040 - % POOL used 

100 - % CKPT space used 

200 - clock time of metrics 

400 - trailing blank line after the metrics 


/SK :nnn Skip nnn files when opening tape input file 
/RW /-RW ReWind tape input file before opening 

/1TS * Process hook records only for listed TaSks 
/uc * Process hook records only for listed 


devices as Tl: 


* ~ the switches /NT and /TS are mutually exclusive. 
- the switches /NU and /UC are mutually exclusive. 
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MDR -- 
MDR -- 


MDR -- 


MDR -- 
MDR -- 


MDR --~ 
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This section discusses the messages which MDR can issue. 


PLEASE ENTER TASKNAMES ONE AT A TIME FOLLOWING EACH 

WITH A <CR>. TYPE JUST A <CR> AFTER THE LAST ONE IS 
ENTERED 

TSKNAM> 


Explanation: This is the prompt for the generic task- 
names for filtering by the /NT or /TS switch. The last 
line of this message is repeated for each line of input. 


User Action: Enter generic task name(s). 


PLEASE ENTER TI DEVICES (DDNN:) ONE AT A TIME FOLLOWING 
EACH 

WITH A <CR>. TYPE -JUST- Ay <OR> AFTER: THE LAST ONE tS 
ENTERED 

TI DEVICE> 


Explanation: This is the prompt for device names to be 
used by the /UC or /NU filter. The last line of this 
message is repeated for each line of input. 


User Action: Enter full device name(s) as "DDnn:". 


YOU MUST NOW SORT THE INTERMEDIATE FILE BY USING DRS.TSK 
(E.G.) MCR>DRS 
RESOURCE.SRT=RESOURCE.TMP/FO :V :156/KE :1.12/PR :T 

AFTER THE SORT HAS COMPLETED, RESUME THIS TASK (TSKNAM) 


Explanation: This message indicates that the first pass 
of MDR has completed. Manual intervention is now 
required to run the DRS task with the given command. 
The task name under which MDR is running is given in 
parentheses in the last line of the message. 


User Action: Run the DRS task (@DRS.CMD), and when it 
has completed, resume the MDR task. 


DSWitttee# F.ERR ###### OSB ####HH FHHHHH PC HAH HHE 
SP i##t tt # 
STK i##tide ##eHHH we. 


Explanation: This is a status message which gives 


detail of the internal state of MDR at the time when an 
error is detected. This message is always followed by 
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one of the messages discussed below, which describes the 
actual error condition. 


User Action: See action specified for the message 
issued immediately following this status message. 

AN INCOMPLETE RESOURCE UTILIZATION REPORT WILL BE 
PRODUCED 

Explanation: An error occurred which prevented the 
completion of pass II of MDR. Although a report will be 
produced, not all task-workload data has been summa- 
rized. A previous error message is issued giving the 
cause of this condition. 


User Action: As specified for previous message. 


ATTEMPT TO PRINT NULL TWB 


Explanation: An internal inconsistency occurred in the 
pass II processing of MDR. 


User Action: * * * SPR 1! 
ATTEMPTING TO DEALLOCATE TWB NOT IN TSKHD 


Explanation: An internal inconsistency occurred in the 
pass I processing of MDR. 


User Action: * * * SPR ! 


CHECKPOINT USAGE > 100% 

Explanation: A Checkpoint metric indicates more than 
100% usage of the checkpoint space. The metric is not 
reported. 


User Action: Ensure logfile is not corrupted. 


CLOCK STOPPED OR HOOK RECORD OUT OF TIME SEQUENCE. 
Explanation: The records in the logfile do not follow a 
strict time sequence. This condition invalidates the 
data in the logfile. 


User Action: Ensure that the KW11-P clock is 
functioning. Re-collect the data. 
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COMMAND READ ERROR 


Explanation: An I/O error occurred while attempting to 
read the MDR command line. 


User Action: Reenter the MDR command. 


COMMAND SYNTAX ERROR 


Explanation: The command as entered has’ improper 
syntax. 


User Action: Reenter the corrected MDR command. 


COMPLETION ERROR IN INPUT READ 


Explanation: An 1/0 error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 


symptomatic of a corrupted logfile. 

User Action: Check IOSB for error cause. Rerun MDR 
using another logfile if necessary. 

CONFLICTING SWITCHES /TS+/NT OR /UC+/NU 

Explanation: The switches /TS and /NT were both speci- 
fied, or the switches /UC and /NU were both specified. 


Only one of each pair of switches may be specified. 


User Action: Reenter the command line without both of 
the conflicting switches. 


DEVICE USAGE > 100% 

Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of device utili- 
zation. No graphic output will be produced for the 


suspect record. 


User Action: * * * SPR ! 
DEVICE'S ACP NOT FOUND 


Explanation: The system information records indicated 
that a device was mounted, yet no TCB for the ACP task 
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was found. The device may have been dismounted concur- 
rently with COL's scan of the system configuration. A 
generic ACP name will be used for the device's ACP 
functions. 


User Action: None. 


DYNAMIC SPACE ALLOCATION FAILURE 


Explanation: MDR was unable to sufficiently extend 
itself to provide space for initialization of pass I. 
This indicates a severe shortage of necessary dynamic 
space. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. Use overlaid version of MDR. 


ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation: An 1/0 error occurred when attempting to 
open the logfile on magtape. The drive may have been 
mounted to MTAACP which is incorrect since MDR does QIOs 
directly to the tape device driver. 


User Action: Correct the condition and rerun MDR,. 


ERROR CLOSING INPUT FILE 


Explanation: An 1/0 error occurred when closing the 
input logfile. 


User Action: None. 


ERROR CLOSING REPORT FILE 


Explanation: An 1/0 error occurred when closing the 
report file. This file will not be properly closed or 
spooied, or MDR attempted to spooi the output file but 
the task PRT... was not installed. 


User Action: Correct the condition and manually close 
the file, or rerun MDR. 
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ERROR CLOSING RESOURCE.TMP FILE 

Explanation: An I/O error occurred at the end of pass I 
when closing the RESOURCE.TMP file. The DRS task will 
not be able to read this file until it is properly 
closed. 

User Action: Correct the condition and manually close 
the file, or rerun MDR. 

ERROR DELETING RESOURCE.TMP FILE 

Explanation: An I/O error occurred when MDR deleted 
its temporary file. The file is not properly closed, or 
deleted. 


User Action: Manually unlock and delete this file. 


ERROR IN GTSK$S 

Explanation: The directive failed preventing MDR from 
obtaining its taskname. The message requesting the sort 
to be run will not include MDR's taskname. 


User Action: None. 


ERROR IN INPUT READ QIO 


Explanation: An I/0 error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 


Symptomatic of a corrupted logfile. 

User Action: Check DSW for error cause. Rerun MDR 
using another logfile if necessary. 

ERROR OPENING RESOURCE.SRT FILE 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE.SRT file for pass II. 


Pass II will not be able to run. 


User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 
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ERROR OPENING RESOURCE.TMP FILE 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE.TMP file for write in 
pass I. Pass I will not be able to run. 

User Action: Correct the condition indicated by F.ERR 
and rerun MDR., 

ERROR OUTPUTTING PRINT LINE 

Explanation: An error was reported by FCS when MDR 
attempted to output a record to the report file. MDR 
will attempt to continue to produce the report. If this 
error is not caused by a transient condition the message 
will be repeated, and MDR will have to be aborted. 


User Action: Correct the condition and rerun MDR. 


ERROR READING MPB 


Explanation: An 1/0 error occurred when attempting to 
read the first block of the logfile. 


User Action: Correct the condition and rerun MDR. 


ERROR READING RESOURCE.SRT FILE 

Explanation: An I/0 error occurred in pass II when 
attempting to read from the RESOURCE.SRT file. This 
will be treated as an end-of-file condition. 


User Action: Correct the condition and rerun MDR. 


ERROR REOPENING RESOURCE.TMP FILE 

Explanation: An I/0 error occurred when attempting to 
re-open the RESOURCE.TMP file so it could be deleted. 
The RESOURCE.TMP file will not be deleted. 


User Action: Delete the file manually. 


ERROR SKIPPING OVER MPB BUFFER 
Explanation: An I/0 error occurred when repositioning 


the tape logfile so the MPB could be reread once the 
buffer size is known. 
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User Action: Correct the condition and rerun MDR. 


ERROR WRITING RESOURCE.TMP FILE 


Explanation: An I/0 error was reported by FCS for a 
write operation during pass I. 


User Action: Correct the condition and rerun MDR. 


EXPECTED RIB NOT FOUND 


Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 


User Action: See Chapter 7, Section 7.3. 


EXPECTED RWB PREDECESSOR NOT FOUND IN OVERLAP 


Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 


User Action: * * * SPR ! 


EXPECTED RWB PREDECESSOR NOT FOUND IN MERGE 


Explanation: An inconsistency occurred in  MDR's 
internal dynamic data structures. 


User Action: * * * SPR ! 


IDOLE. TIME > 100% 

Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of CPU idle time. No 
graphic output will be produced for the suspect record. 
User Action: See Chapter 7, Section 7.8. 


MPROPER FORMAT OR NO SUCH DEVICE IN SYSTEM. PLEASE 
ET 


I 
RETYPE 


Explanation: An improper response was entered to the 


prompt for TI filter devices. 


User Action: Enter a corrected response. 
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INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: An improper command line was used with 
MDR. 


User Action: Reenter the command. 


INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with the correct 
density. 

INVALID DEVICE SPACE METRIC RECORDED 

Explanation: A system metric record indicates more than 
100% of device space used. The device space metric will 
not be reported. This metric is only available for 


devices mounted to FI11ACP. 


User Action: Ensure logfile not corrupted. 


INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to reduce a logfile 
which is not on either a disk or tape volume. MDR can 
only use disk or tape for the input file. 

User Action: Do not use MDR to read logfiles not 
residing on disk or tape. 


INVALID INPUT FILESPEC 


Explanation: A syntax error occurred in the input 
filespec part of the MDR command. 


User Action: Correct and reenter the command. 


Explanation: An invalid listing level was specified in 
the /LI switch. Acceptable values range from 0 to 5. 


User Action: Correct and reenter the command. 
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INVALID MPB FOUND BY ALC 

Explanation: The logfile was found to contain improper 
data. This may be a result of using MDR to read a 
logfile produced by an incompatible COL version. This 
may also be the result of using MDR to read a file which 
was not produced by COL, or was corrupted. 


User Action: Rerun MDR using a valid logfile. 


INVALID MPB FOUND BY INF 

Explanation: The MPB did not pass validity testing when 
it was reread once the logfile buffer size was known. 
The logfile may have been corrupted while MDR was 
processing it. 


User Action: * * * SPR ! 


INVALID POOL METRIC RECORDED 


Explanation: A Pool metric indicates more than 100% DSR 
usage. The metric is not reported. 


User Action: Ensure logfile is not corrupted. Do not 
change DSR size while COL is running. 

INVALID RAD50 CHARACTER IN YOUR INPUT. PLEASE RETYPE. 
Explanation: The response to the taskname prompt for 
filtered names was not a valid RSX-11M taskname. All 


letters should be in uppercase. 


User Action: Correct and retype the response. 


INVALID TIME VALUES; /AF MUST BE EARLIER THAN /BF 
Explanation: An attempt to use time filter values which 
overlapped causes this message. This condition will not 
allow any records to pass the filter for processing. 


User Action: Correct and reenter the MDR command. 
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Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of partition utili- 
zation. No graphic output will be produced for the 
Suspect record. 


User Action: * * * SPR ! 


MISSING INFO FOR DEVICE METRIC 

Explanation: The Info record describing the system 
metric device was not found. Device system metrics will 
not be reported. 

User Action: Do not load or unload device drivers while 
COL is active. Ensure logfile is not corrupted. 


MISSING I$SYS FOR POOL METRIC 


Explanation: The DSR size was not found in the logfile. 
The Pool system metric is suppressed. 


User Action: Ensure logfile is not corrupted. 


MISSING “=" AND INPUT FILESPEC 

Explanation: The input command contains no "=" and no 
input filespec. Both input and output filespecs must be 
supplied or defaulted. 

User Action: Enter a corrected MDR command including 
the Wen 

MORE THAN ONE INPUT FILESPEC NOT ALLOWED 


Explanation: The MDR command contains more than one 
input filespec. 


User Action: Enter a corrected MDR command with only 
one input filespec. 


MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 


Explanation: The MDR command contains more than one 
output filespec. 
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User Action: Enter a corrected MDR command with only 
one output filespec. 

MPB FOUND AT LOCATION OTHER THAN FIRST RECORD OF FILE 
Explanation: An MPB was read in the wrong position in 
the logfile. This is indicative of a corrupted logfile. 
MDR will bypass this MPB and attempt to continue to 
process the corrupted logfile. Reports produced from 
this logfile are suspect. 


User Action: Use a different logfile for analysis. 


MPB NOT FOUND - NOT TRACE FILE 

Explanation: The MDR input file did not begin with a 
MPB. Either the file was corrupted or it is not a 
logfile. 


User Action: Use a different logfile for analysis. 


NQ FOLLOWING PRIMARY RWB FOUND 


Explanation: An internal inconsistency was detected in 
pass I. 


User Action: * * * SPR ! 


NO FPP OR BUILT /-FP 

Explanation: MDR is unable to initialize for FPP ASTs. 
Either MDR was taskbuilt with the /-FP switch, or the 
processor where MDR is running has no FPP. This message 
cannot occur if the EIS version of MDR is used. 

User Action: Rebuild MDR using the distributed .CMD 


file. Only run the FPP version of MDR on processors 
with an FP-1ll. 


OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the output 
filespec or an invalid output switch was specified. 


User Action: Correct and reenter the MDR command. 
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OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The logfile indicates buffer overflow 
occurred before the MPB was written. Either the logfile 
was corrupted, or the file was not produced by COL. 


User Action: Use another file for MDR input. 


OVERFLOW IN FIRST PASS SUMMARIZATION 


Explanation: A floating overflow occurred in pass I. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 


User Action: Use. the resulting report with caution. 
Use filtering to limit the amount of data processed to 
prevent this condition. 

OVERFLOW IN SECOND PASS SUMMARIZATION 

Explanation: A floating overflow occurred in pass II. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 

User Action: Use the resulting report with caution. 


Use filtering to limit the amount of data processed to 
prevent this condition. 


PARTITION RIB NOT FOUND FOR S$MEM 

Explanation: A system metric record was read for a 
partition which was not described by the system con- 
figuration information records. The graphic output of 


memory utilization will be suppressed. 


User Action: None, 


PRINT LINE TOO LONG 

Explanation: MDR generated a report file record longer 
than 132 bytes. The line is truncated by the logic 
which writes to the file. 


User Action: * * * SPR ! 
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RIB LIST LINKAGE ERROR 


Explanation: An inconsistency was detected in MDR's 
internal representation of the system configuration. 


User. Action: F-* * SPRY! 


RWB WITHOUT TWB FOUND IN RESOURCE.TMP 

Explanation: A record in the RESOURCE.SRT file was 
encountered in an illogical position. The record is 
disgarded. 


User Action: * * * SPR ! 


SUMMARIZING FROM NULL TWB 


Explanation: An inconsistency was detected in the pass 
II data structures. 


User Action: * * * SPR ! 


SUMMARIZING INTO NULL TWB 


Explanation: An inconsistency was detected in the pass 
II data structures. 


User ACTON:  *-* * SPR! 


SVTK FAILURE 


Explanation: The RSX executive rejected MDR's attempt 
to specify an SST vector. 


User Action: Correct the condition indicated by the DSW 
and rerun MDR. 

SYSTEM + IDLE TIME > 100% 

Explanation: A system metric record was read which 
indicates the total of kernel and idle time is greater 
than the elapsed time. The graphic output for the 


record is suppressed. 


User Action: See Chapter 7, Section 7.8. 
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SYSTEM TIME > 100% 

Explanation: A system metric record was read which 
indicates more kernel time than elapsed time. The 
graphic output for the record is suppressed. 


User Action: See Chapter 7, Section 7.8. 


TI: READ ERROR 


Explanation: An I/0 error occurred when reading filter 
values from the user. 


User Action: Rerun MDR. 


TRAP ### 


Explanation: A floating point or conversion error 
occurred. The octal number in this message indicates 
the precise error cause. 


User Action: * * * SPR ! 


TRUNCATED INPUT FILE RECORD 


Explanation: The end of a buffer was reached before all 
the records in that buffer were processed. This 
indicates a corrupted logfile. 


User Action: Use a different logfile for analysis. 


TWB/RWB/RIB DYNAMIC SPACE ALLOCATION FAILURE 


Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass I. However sufficent 
dynamic storage was obtained to begin pass I. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. Use of filtering of MDR input will also 
lower this space requirement. Use overlaid MDR. 
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UNABLE TO ALLOCATE RESOURCE.SRT BUFFER 


Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass II. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of filtering of MDR input will lower this space 
requirement. Use overlaid MDR. 


UNABLE TO ALLOCATE RIB 

Explanation: MDR was unable to sufficiently extend 
itself to provide space for initialization of pass lI. 
This indicates a severe shortage of necessary dynamic 
space. 

User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. 


UNABLE TO OPEN INPUT FILE 


Explanation: An 1/0 error occurred when MDR attempted 
to open the logfile. 


User Action: Correct the condition and rerun MDR. 


UNABLE TO OPEN OUTPUT FILE 


Explanation: An 1/0 error occurred when MDR attempted 
to open the report file. 


User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 
UNKNOWN INFO TYPE RECORD FOUND 


Explanation: A corrupted logfile, or ae file not 
produced by COL is being used as MDR input. 


User Action: Use a different file for MDR input. 
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UNKNOWN RECORD TYPE 


Explanation: A corrupted logfile, or a file not 
produced by COL is being used as MDR input. 


User Action: Use a different file for MDR input. 


WILDCARD NOT ALLOWED IN FILESPEC 
Explanation: The MDR command contains a wildcard. 


User Action: Reenter the command without any wildcards. 


WRONG FOLLOWING PRIMARY RWB FOUND 


Explanation: An inconsistency was detected in MDR's 
pass I dynamic data. 


User Action: * * * SPR ! 
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CLF is used to copy logfiles produced by COL. The three modes 
of CLF operation are: 


fo) Buffer Transfer Mode, 


which copies a logfile from either disk or tape, to 
disk or tape, maintaining the logfile format which MDR 
uses for input. 


fe) FCS Record Transfer Mode, 


which copies a logfile from either disk or tape, 
producing an output file with variable length FCS 
records. 


9) Read-only Mode, 


which reads the logfile, computes overflow and buffer 
counts, but does not create a new file. 


The general procedure for using CLF is: 


>RUN CLF. 
CLF> [OUTFILE/sw =] LOGFILE/sw 


Note that the output filespec and "=" are optional. If these 
are not specified, CLF will operate in read-only mode, 
producing no output file. 


When FCS mode is specified (by the /FCS switch), the records 
have the format specified in appendices A through D. The first 
word of each record is the record ID which uniquely identifies 
the record type. If overflows’ occur within the data stream, a 
special “overflow record" is placed in the output file at the 
point where records were lost due to overflow. The format of 
this (length = 4, bytes) record is: 


so 0 600(8) = overflow record ID 


### 2 count of records lost by overflow at 
this point 


When the /FCS switch is used, the default output filespec is 
changed to TRACE.FCS. 


After CLF has completed reading the input file, the run 
statistics will be reported to CLF's Tl:. 
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CLF Switches 


output: SY:TRACE.LOG/-AP/DE :800/-FCS 


input: SY :TRACE.LOG/DE :800/RW/SK :0 


Output Switches 


/ AP /-AP 


/DE :nnnn 
/FCS[ :nnj] /-FCS 


Input Switches 


/DE :nnnn 


/RW /-RW 


/SK innn 
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Description 


APpend file to the end of magtape. CLF 
will space over all existing files on the 
magtape and write the new file starting at 
the current end-of-volume point. 


Selects output magtape DEnsity, 800 or 1600 


Selects FCS sequential records in the 
output file, and changes the default output 
filespec to TRACE.FCS. If "inn" is not 
specified, all record types will be copied. 
If "inn" is specified, only selected record 
types will be written. "nn" is the total 
for desired record types: 


001 - overflow records 

004 - system configuration records 

010 - task event hook records 

020 - system metric records 

040 - user information records 

100 - load disk overlay records 

200 - call directive processor records 


Selects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is also used) @ 


ReWind tape input file before opening 


SKip nnn files when opening tape input file 
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ssages 


F messages are issued to the TI device under which CLF is 
This section discusses the messages which CLF can issue. 


#### BUFFERS READ 

#### RECORDS READ 

#### BUFFERS WITH OVERFLOW 

#### RECORDS LOST BY OVERFLOW 

Explanation: This statistics message is output at the 
completion of each run of CLF, indicating the statistics 
about the input file. 

User Action: None. 

#### FCS RECORDS WRITTEN 


Explanation: This statistics message is output when CLF 
produces an FCS output file. 


User Action: None. 
DSW :###### F.ERR:###### I0SB :####4### ###HHHE PC c###H HHH 


SP :#####¢4 
STK :###### ###HHE 


Explanation: This is a status message which gives 
detail of the internal state of CLF at the time when an 
error is detected. This message is always followed by 
one of the messages discussed below, which describes the 
actual error condition. 

User Action: See action specified for the message 
issued immediately after this status message. 

COMMAND READ ERROR 


Explanation: An 1/0 error occurred while reading the 
command line. 


User Action: Reenter the command. 


COMMAND SYNTAX ERROR 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


GUIDE TO USING SPM-11M 3-47 


CLF -- 


CLF a< 


CLF -- 


CLF -- 


Ck oe 


1/82 


COMPLETION ERROR IN INPUT READ 

Explanation: an I/O error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted logfile, will be treated as end-of-file. 
User Action: Check F.ERR and IOSB for error cause, or 
use another logfile. 


ERROR ASSIGNING INPUT DEVICE 


Explanation: CLF was unable to assign a LUN to the 
input file. 


User Action: Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 
ERROR ASSIGNING OUTPUT DEVICE 


Explanation: CLF was unable to assign a LUN to the 
output file. 


User Action: Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 

ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 


Explanation: An I/0 error occurred when attempting to 
open a file on magtape. 


User Action: Ensure the drive is not mounted if logfile 
format is used for that file. Ensure the output drive 
is selectable, and not write locked. Correct the error 
indicated by DSW or IOSB. 
ERROR CLOSING INPUT FILE 


Explanation; An I/0 error occurred when closing the 
input file. 


User Action: None, 
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ERROR CLOSING OUTPUT PILE 


Explanation: An I/O error occurred when truncating or 
closing the output file. 


User Action: Correct the condition and rerun CLF, or 
manually unlock the output file. 

ERROR IN INPUT READ QIO 

Explanation: An 1/0 error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted logfile, will be treated as end-of-file. 
User Action: Check DSW for cause. Rerun using another 
logfile if necessary. 

ERROR READING MPB 


Explanation: An 1/0 error occurred when reading the 
first block of the logfile. 


User Action: Correct the condition and rerun. 


ERROR WRITING TO OUTPUT FILE 


Explanation: An 1/0 error occurred when writing to the 
output file. 


User Action: Correct the condition and rerun. 


INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the input 
filespec. 


User Action: Reenter the corrected command. 


INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with a correct 
density. 
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INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to read a file not on 
disk or tape. Disk and tape are the only acceptable 
media for logfiles. 

User Action: Do not use CLF to read files not on disk 
or tape. 

INVALID MPB FOUND 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile, or a logfile produced by an incompatible 
version of COL. 


User Action: Use a different logfile. 


INVALID OUTPUT DEVICE TYPE 


Explanation: An attempt was made to write in logfile 
format to. a device other than disk or tape. 


User Action: Only write logfile format to disk or tape. 


MORE THAN ONE INPUT FILESPEC NOT ALLOWED 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


MPB NOT FOUND - NOT TRACE FILE 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile. 


User Action: Use a different logfile. 
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OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the output 
filespec. 


User Action: Reenter the corrected command. 

OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile. 

User Action: Use a different logfile. 

TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before all 
records in that buffer were processed. This indicates a 
corrupted logfile. 

User Action: Use a different logfile. 

UNABLE TO OPEN INPUT FILE 


Explanation: An 1/0 error occurred while opening the 
input file. 


User Action: Correct ne condition sand rerun. 
UNABLE TO OPEN OUTPUT FILE 


Explanation: An I/0 error occurred while opening the 
output file. 


User Action: Correct the condition and rerun. 
UNKNOWN RECORD TYPE 


Explanation: An unknown record ID was found in the 
file. 


User Action: Use a different logfile. 


WILDCARD NOT ALLOWED IN FILESPEC 
Explanation: A wildcard was found in the command. 


User Action: Reenter the command without wildcards. 
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OVL is used to read a logfile and produce a report showing the 
disk resident overlay activity for a task. 


A memory-resident overlay segment is loaded from disk the first 
time that the segment is referenced. If a task has memory- 
resident overlays, OVL will count their initial loads in the 
overlay report. Subsequent memory-resident overlay "loads" 
will not be counted, since a disk load is not performed. 


OVL has two input files: 


1) A mapfile for the task whose disk resident overlays 
are to be analyzed. 


a) AS POGTT hex 


In addition, the taskname switch /TS:tsknam must be appended to 
the logfile specification. If the taskname specified by 
/TS:tsknam is a generic taskname, @.gGe-, «+e-X¥Z, then all 
overlay hook records with the same generic taskname will be 
analyzed for the overlay report. If the taskname is not 
generic (not of the form ...XYZ), then only the hook records 
whose tasknames exactly match the /TS:tsknam taskname will be 
analyzed for the overlay report. 


The overlay report lists all the segment names for a task and 
prints the number of times each segment was loaded. 


In addition, you can trace each overlay load by using the /TR 
switch on the output file. As each overlay hook record is 
read, the segment name and the number of times that segment has 
been loaded up to that point will be printed. 

The command syntax for OVL is: 


>RUN OVL 
OVL> OUTFILE/SW = MAPFILE, LOGFILE/TS :tsknam 
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output: SY:TRACE.RPT/-TR 
input mapfile: SY:TRACE.MAP 
input logfile: SY:TRACE.LOG/DE :800/RW/SK :0 


Output Description 
Switches 


Print a trace of each overlay segment, 
giving the segment name and the number of 
times the segment has been loaded up to that 
point. 


(to logfile) 


This switch is required. If "“tsknam" is of 
the form ...XYZ, all hook records with same 
generic task name will be included for 
overlay analysis; if "tsknam" is not of the 
form ...XYZ, then only hook records with; 
tasknames exactly matching "“tsknam" will be 
included for overlay analysis. | 


| 


'/DE :nnnn Selects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is all used) 

/RW /-RW Rewind tape input file before opening 

/ SK :nnn Skip nnn files when opening tape input file 
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This section discusses the messages which OVL can issue. 


DSW:td#ttee F.ERR:###### IOSB #####H HHHHHE PC :###### 
SP :###### 

STK :###### #A#HHE Wn. 

Explanation: This is a status message which gives 
detail of the internal state of OVL at the time when 
an error is detected. This message is always followed 


by one of the messages discussed below, which 
describes the actual error condition. 


User Action: See action specified for the message 
issued immediately after this status message. 


COMMAND READ ERROR 


Explanation: An I/0 error occurred while reading the 
command line. 


User Action: Reenter the command. 

COMMAND SYNTAX ERROR 

Explanation: The command has improper Syntax. 

User Action: Reenter the corrected command. 
COMPLETION ERROR IN INPUT READ 

Explanation: an I/0 error occurred while reading the 
input file. This condition, which may be Symptomatic 
of a corrupted logfile, will be treated as 


end-of-file. 


User Action: Check F.ERR and IOSB for error cause, or 
use another logfile. 


ERROR ASSIGNING INPUT DEVICE 


Explanation: OQVL was unable to assign a LUN to the 


input file. 


User Action: Check DSW and F.ERR for cause. Ensure 
the filespec syntax is correct. 
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ERROR ASSIGNING OUTPUT DEVICE 


Explanation: OVL was unable to assign a LUN to the 
output file. 


User Action: Check DSW and F.ERR for cause. Ensure 
the filespec syntax is correct. 


ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 


Explanation: An I/0 error occurred when attempting to 
open a file on magtape. 


User Action: Ensure the drive is mounted foreign. 
Correct the error indicated by DSW or IOSB. 


ERROR CLOSING INPUT FILE 


Explanation; An I/0 error occurred when closing the 
input file. 


User Action: None, 
ERROR CLOSING OUTPUT FILE 


Explanation: An 1/0 error occurred when closing the 
output file. 


User Action: Correct the condition and rerun OVL or 
manually unlock the output file. 


ERROR IN INPUT READ QIO 

Explanation: An 1/0 error occurred while reading the 
input file. This condition, which may be Symptomatic 
of a corrupted logfile, wil] be treated as 
end-of-file. 


User Action: Check DSW for cause. Rerun using 
another logfile if necessary. 


ERROR READING MPB 


Explanation: An I/0 error occurred when reading the 
first block of the logfile. 


User Action: Correct the condition and rerun. 
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ERROR PARSING MAP FILE 


Explanation: OVL could not parse the specified file 
into overlay segment names and segment block numbers. 


User action: Input a valid map file. 

ERROR PRINTING OVERLAY SUMMARY 

Explanation: An 1/0 or formatting error occurred when 
attempting to print the summary section of the overlay 
report. 

User action: Correct the condition and rerun. 

ERROR PRINTING OVERLAY TRACE 

Explanation: An I/0 or formatting error occurred when 
attempting to print the trace section of the overlay 
report. 

User action: Correct the condition and rerun. 
INCONSISTENCY BETWEEN MAP FILE AND LOG FILE 
Explanation: The overlay block numbers in the logfile 
for task specified by /TS:tsknam do not appear in the 
map file. 

User Action: Be sure the map file is correct for all 
tasks in logfile with generic taskname specified by 
/TS:tsknam. 

INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the input 
Tilespec. 


User Action: Reenter the corrected command. 
INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with a correct 
density. 
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INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to read a file not 
on disk or tape. Disk and tape are the only 
acceptable media for logfiles. 


User Action: Do not use OVL to read files not on disk 
or tape. 


INVALID MPB FOUND 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action: Use a different logfile. 

MORE THAN TWO INPUT FILESPECS NOT ALLOWED 

Explanation: The command has improper syntax. 

User Action: Reenter the corrected command. 

MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 

Explanation: The command has improper syntax. 

User Action: Reenter the corrected command. 

MPB NOT FOUND - NOT TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action: Use a different logfile. 


OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the 
output filespec. 


User Action: Reenter the corrected command. 
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OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action: Use a different logfile. 

TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before 
all records in that buffer were processed. This 
indicates a corrupted logfile. 

User Action: Use a different logfile. 

UNABLE TO OPEN INPUT FILE 


Explanation: An I/0 error occurred while opening the 
input file. 


User Action: Correct the condition and rerun. 
UNABLE TO OPEN OUTPUT FILE 


Explanation: An I/0 error occurred while opening the 
output file. 


User Action: Correct the condition and rerun. 
UNKNOWN RECORD TYPE 


Explanation: An unknown record ID was found in the 
file. 


User Action: Use a different logfile. 


WILDCARD NOT ALLOWED IN FILESPEC 


‘Explanation: A wildcard was found in the command. 


User Action: Reenter the command without wildcards. 
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S62%7 Writing User Information to the Logfile 


The QPDRV driver provides a way for a user task to write user 
information to the same logfile that COL currently has open. A 
task does this by issuing a QIO to QP:, with up to six words 
of user information specified in the QIO parameter words. 


The QPDRV driver is similar to the null driver NLDRV. It is an 
infinite sink for writes and an infinite source of EOFs for 
reads. QPDRV is compatible with FCS and RMS QIO functions. 
All of the following QIO functions are defined as legal and 
control for QPDRV: IO.KIL, IO.RLB, ITO.WLB, IO.ATT, IO.DET, 
IO.FNA, IO.ACR, IO0.ACW, IO.ACE, IO.DAC, IO0.RVB and IO.WVB. 


QPDRV contains a hook point defined as H$USER. When a QIO is 
issued to QP:, a hook record with hook ID H$USER is written. 
The H$USER record contains the six QIO parameter words speci- 
fied by the user. See Appendix A for a complete specification 
of the hook record. 
To use QPDRV, you must load it by the command: 

>LOA QP: 


QPDRV is built via the command file PMONBLD.CMD. The image and 
symbol table files for QPDRV are contained in [1,54]. 


Example: 


ALUN$C 1,QP,0 
QIOWSC 1O.WLB 41514555 *1005200,300,400,500,600> 


will result in a H$USER record with the QIO parameters 100, 
200, 300, 400, 500 and 600 written to the logfile. 


To dump a stream of H$USER records in the performance report, 
you run MDR and use the /DM:40 switch. If you only want the 
H$USER records printed, the suggested command syntax is: 

MDR> output=input/DM :40/LI :0/SI :0 . 
Usage note: If you enable device type "OTHER" in SMPGEN, then 
for each QIO to QP:, three hook records are written: H$QDRV, 
H$IODN and H$USER. However, if you disable device type "OTHER" 


is written. 
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Chapter 4 


DATA COLLECTION AND 
REDUCTION PROCEDURES 


COL and MDR are complementary tools which can be used to 
collect large amounts of performance data and interpret the 
data to a great degree of precision. Both COL and MDR have a 
number of parameters and switches which provide flexibility in 
both collecting and interpreting the data. In the following 
sections we describe how to utilize the parameters of COL and 
MDR to collect the best possible set of data to analyze your 
computer system. 


4.1 DATA COLLECTION PROCEDURE 


There are a number of questions you should answer before 
running COL to collect data: 


9) Length and type of measurement interval? 

0) Resource types enabled for data collection? 
fe) Device classes enabled for data collection? 
0 Tasks enabled for data collection? 


0 System metrics enabled? 


Ae hed Measurement Period 


The measurement period is defined as the time during which COL 
is collecting data. Typically this time is one continuous time 
interval; however, it may consist of a number of time intervals 
piecewise added together. 
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Under most conditions, you should select a continuous measure- 
ment period. This is done by running COL either in MANUAL mode 
or AUTOSTOP mode. 


MANUAL mode should be used when: 
0) There is an operator available to terminate COL. 


0 You estimate the logfile space available is sufficient 
to contain all the data collected for the measurement 
period. 


AUTOSTOP mode should be used when: 
O An operator is not available to terminate COL. 


0 You want to run COL for a fixed amount of time 

(AUTOSTOP on TIME). 

) You want to set a limit on the amount of logfile space 
used (AUTOSTOP on BUFFER). 


Under some conditions, particularly if the system is under 
heavy activity for long periods of time, COL will collect too 
much data given the available logfile space. To reduce the 
logfile space used, you can run COL in REPEAT mode. However, 
you should do so carefully. The chief concern when running COL 
in REPEAT mode is that “incomplete intervals" may result if a 
task or operation is outstanding exactly when COL starts or 
stops data collection. For example, if you start COL precisely 
when a task is active and has an I/0 operation queued to the 
disk, an incomplete interval will be flagged by MDR for both 
the task invocation and for the I/0 operation. This condition 
does not invalidate other information in the _ performance 


report, it just "leaves out" some information which potentially 


may be valuable. You can minimize the number of incomplete 
intervals by minimizing the number of times COL enables or 
disables data collection for a measurement period. 


Let's say you want to collect data during a normal 8-hour 
daytime shift and you have only one 2400 foot magtape available 


for the logfile. However, you estimate that if COL runs all 
day, about two 2400 foot tapes will be needed. What you need 


GyVeuc mpoebUucu e noo u 


to do is cut the amount of data collected in half. Consider 
the following alternative measurement schemes: 


O Sample time = 1 minute; Time between samples = 
1 minute. 
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) Sample time = 30 minutes; Time between samples = 
30 minutes. 


rc) Sample time = 2 hours; Time between samples = 
2 hours. 


Scheme 1 will usually result in the highest number of 
incompletes, yet it probably will not "miss" any important 
system activity. Scheme 3 will probably result in the lowest 
number of incompletes, yet it is vulnerable to missing 
important intervals of system activity. Scheme 2 will probably 
result in a low number of incompletes, yet it has a good chance 
of capturing all periods of important system activity. 


What we're observing here.is an old problem in communications 
systems: How fast do you sample a signal to be able to 
reconstruct the signal from the sampled data? In our case, the 
problem is: how fast do you sample the workload in order to 
reconstruct it? 


In communication systems, you sample the signal at twice the 
highest frequency in the signal. In computer systems, it would 
be reasonable to sample the workload at twice the highest 
frequency of variation in the workload. Thus if you observe 
the workload to fluctuate up and down about four times per 
shift, then 8 samples per shift (every 30 minutes) would reduce 
the amount of data and yet collect sufficient data to 
reconstruct the workload. 


4.1.2 Resource Types 


Normally you want to collect data for all resource types (CPU, 
memory, I/0). If the amount of data collected is too large, 
you can select one resource type per measurement period and run 
a number of measurement periods. 


The hooks are grouped according to resource type. To select a 
particular resource type, you select the corresponding hook 
group. 


4.1.3 Device Classes 


The device classes are: Directory, Sequential, Terminal, and 
Other. If you want to measure the resource contention for a 
device, select it for data collection. Normally the disks are 
Shared devices and should be selected. If the line printer is 
spooled and attached to the despooler task you may not need to 
collect usage data for it. Similarly, terminals are normally 
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singly used by one task at a time; the measurement results may 
not be useful from a resource contention point of view. 


4.1.4 Tasks 


The tasks selected for data collection are the definition of 
the workload that you want to measure. For example, if you 
want to analyze the application workload, select all the tasks 
in that workload and deselect the system service tasks such as 
FI1ACP, MCR..., and QMG.... On the other hand, if you want to 
measure the system resources that a particular F11lACP is 
consuming, enable only FI1IACP and disable all other tasks. 


4.1.5 System Metrics 


Normally system metrics should be enabled with ae sample 
interval of 60 seconds. If you want to save logfile space and 
report paper, longer sample intervals may be used. 


4.2 DATA REDUCTION PROCEDURE 


Once you have a logfile on disk or tape, you are ready to read 
the logfile with MDR and reduce the data to a usable perfor- 
mance report. A guide to reading the performance report is 
given in Chapter 5. 


The data reduction procedure should consist of a number of 
steps methodically performed. A general guideline is to first 
obtain a number of overviews of the system activity during the 
entire measurement period and then print detailed analyses of 
the subset measurement intervals of interest. For example, if 
during an 8 hour shift there were two intervals of peak 
activity. trom 9. to: Lb a.m, and from. 2 to 4: p.m... you should 
first run MDR with /LI:0 to get a system metrics scan of the 
entire 8 hour shift, and then run MDR with /AF and /BF to get a 
report of only the peak morning activity and again with /AF and 
/BF to get only the peak afternoon activity. The general 
procedure is as follows: 


0 Run MDR with /LI:0 for entire logfile. 
Identify the intervals of interest and record their 
endpoints of time using the KW11-P clock timestamps 
printed above the system metrics. 


re) Rerun MDR once for each subset measurement interval 
using /AF and /BF with the /LI:2 switch. 
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This will give both system and task summaries. 
Identify the largest consumers of resources and record 
their tasknames. 


Rerun MDR with /L1I:4 or /LI:5 and /TS for the tasks 
desired. 


Observe a detailed analysis of the particular tasks 
which consumed the resources and the times when these 
resources were consumed. 
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Chapter 5 


READING THE 
PERFORMANCE REPORT 


Dead PERFORMANCE REPORT DATA 


When reading this section, refer to Appendix F, which contains 
a sample performance report. 


The performance report consists of four sections: 
9) Measurement Parameters 
“0 System Configuration 
(0) System Metrics 


re) Task Metrics 


bile Measurement Parameters 
The measurement parameters are read from the Monitor Parameter 
Block (MPB) which is the first block of the logfile. The MDR 
task extracts the information from it and prints the measure- 
ment parameters on the first page of the performance report. 
The items printed are: 

0 Label. 

6) Measurement mode. 

) Buffer type, partition, number and size. 

9) Resources selected for System Metrics. 


Oo TI filter device (if selected). 


fe) Tasks selected for data collection. 
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0) Devices selected for data collection. 
0 Hooks enabled. 


oO MDR command line. 


5.1.2 System Configuration 


The system configuration information is contained in the 
Information Records and directly follows the MPB in the 
logfile. If the /SC switch is specified, the MDR task will 
extract the information from these records and print it to the 
logfile. The information printed is: 


fe) The Pool (DSR) size in bytes and the executive feature 
masks. 


0) A list of the partitions in the system when COL was 
activated. 


f°) A list of the controllers and units in the system when 
COL was activated. 


0) A list of the tasks installed in the system when COL 
was activated. 


fo) A list of the active checkpoint files and their sizes 
when COL was activated. 


Diecdie 3 System Metrics 


The system metrics are system-wide measurements of CPU usage, 
pool usage, the usage of a selected partition, checkpoint file 
usage, and the usage of a selected device. Measurements are 
made for each sampling interval and the results written to the 
logfile. The length of the sampling interval is selected in 
the SMPGEN.CMD procedure. The system metrics are: 


0 CPU Usage 


For each sampling interval, counters are kept for the 
total times spent in kernel and idle states. The 
remainder of the sampling interval time is assumed to 
be user state, To depict CPU usage, a histogram is 
printed on the performance report. Each 1% of time 
spent by the CPU in user mode is represented by a 
single letter "U". Each 1% of time spent by the CPU 
in kernel mode is represented by a single letter "K", 
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The user time is left justified and grows from left to 
right; the kernel time is right justified and grows 
from right to left. If any blank spaces exist in the 
line, they represent CPU idle time. 


Pool Usage 


At the end of each sampling interval, COL scans the 
RSX-11M system pooi and measures the percentage of 
pool in use. The percentage of pool used is 
represented by a histogram, where each "P" represents 
1% of pool usage. 


Partition Usage 


The user selects a partition to be monitored via the 
COL switch /PR:parnam. At the end of each sampling 
interval, COL scans the partition data structures for 
the selected partition to measure the percentage of 
the memory in use in the partition. The percentage of 
memory used in the partition is represented by a 
histogram, where each "M" represents 1% of partition 
usage. 


Checkpoint File Usage 


When COL is activated, it scans the checkpoint file 
list and records a list of all active checkpoint files 
and their sizes. 


At the end of each sampling interval, COL scans the 
checkpoint file list and measures the percentage of 
all active checkpoint file space in use. If there is 
more than one checkpoint file, COL sums the space in 
all checkpoint files to compute the percentage. The 
percentage of checkpoint file space used is repre- 
sented by a histogram, where each "C" represents 1% of 
checkpoint file space usage. 


Device Usage 


The user selects a device to be monitored via the COL 
switch /DV:ddnn. For each sampling interval, COL 
tallies all the 1/0 request times for the selected 
device to get the percentage of time that the 1/0 
device was in use during the sampling interval. The 
percentage of time the device was used is represented 
by a histogram, where each "D" represents 1% of device 
usage time for the sampling interval. 
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In addition, if the device is a Files-11 disk and is 
mounted native, the number of disk blocks used on the 
volume is computed at the end of the sampling 
interval. The percentage of disk space used is 
represented by a histogram where each "B" represents 
* of the total volume space used. 


For each sampling interval, the histograms for CPU, pool, 
memory, checkpoint file space, and device are clustered 
together into six successive lines on the report. 


The end of each sampling interval is timestamped and printed in 
two formats: KW11-P time and RSX-11M system time. 


The KW11-P time is printed as two octal numbers: the left 
number is the high order part and the right number is the low 
order part. The corresponding RSX-11M system time is printed 
ast wINS SEC. TENTHS 


The KW11-P timestamp can be used to: 


6) Correlate an individual task report page (which has 
the same form of timestamp) with a particular system 
metric line. 


0) Select a particular measurement interval of interest 
by rerunning MDR using the /AF and /BF switches. 


The totals for CPU kernel time, CPU idle time and device busy 
time are given for each measurement interval. 


The last item in the system metrics section is the "Total Data 
Reduction Period". This is the total time for which data was 
reduced. If the report was generated using the /AF and /BF 
Switches, only the data reduced between /AF and /BF is counted. 


bad oA Task Metrics 
Levels of Task Summarization 


The task metrics describe the usage of the resources in the 
System on a task-by-task basis. There are a number of levels 
of summarization available in the performance report, which 
enables the user to choose between a very detailed report or a 
shorter summarized report. The levels of summarization and 
their corresponding switches are as follows: 
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Individual Task Invocations (/LI:4 or /LI:5) 


An individual task invocation is defined as a single 
run of a task, that is, the time between an executive 
Run Task event and an executive Exit Task event (the 
exact placement of the hooks for these events is 
specified in Appendix A). A complete set of task 
metrics will be printed for each task invocation. If 
most or all tasks in the system are enabled for data 
collection, a report containing individual task 
invocations may be quite long. 


Task by TI Summary (/LI :3) 


In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) and the same TI are grouped together when the 
statistics are computed. The task metrics then reveal 
the measurements summed across all tasks with the same 
generic taskname from the same TI. 


Task Summary (/LI:2) 


In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) are grouped together when the statistics are 
computed. The task metrics then reveal the measure- 
ments summed across all tasks with the same generic 
taskname. 


System-Wide Summary (/LI:1) 


In this level of summary, the task metrics for all 
tasks in the system that were enabled for data 
collection are grouped together when the statistics 
are computed. The task metrics then reveal the 
measurements summed across all tasks in the system. 


Task Metric Data 


The following data is presented in the performance report for 
levels of task summarization. 


all 
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Generic TASK 
The generic taskname (see Chapter 2, Section 2.2.2) is 


printed on the top of the page to identify the task 
for which the data applies. 
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Elapsed Times 


The elapsed time is the time from a Run Task event to 
an Exit Task event. 


Number of Task Invocations 


The Number of Task Invocations is the number of times 
that a Run Task event occurred for the task. If the 
COL task is started while a task is in progress, the 
Run Task event will not be recorded in the logfile for 
that task. When the task exits, an Exit Task event 
will be recorded to the logfile. When MDR reads an 
Exit Task event without a corresponding Run Task 
event, it reports an "incomplete" invocation in the 
Number of Task Invocations line. 


Memory Times 
There are three memory times: 
- In (memory) 


- Qut (memory) - includes time waiting for memory on 
initial task load and all time checkpointed 
(waiting and stopped). 


- Wait (memory) - includes time waiting for memory on 
initial task load and time checkpointed (waiting 
only). 


Memory Size in K Words 
Size of the task region. 
Space-Time Product 


The space-time product is the amount of memory that a 
task uses integrated over the time that the memory was 
used. Each increment of memory used (in K words) is 
multiplied by the time (in SECs) that the increment 
was used, and all products are summed to get the 
space-time product. If a task changes its size via an 
Extend Task directive, the corresponding change in 
memory usage is computed. 
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ACP Counts 


The ACP Counts are tallied across all ACPs in the 
System. They are not broken down by separate ACP. 


There are seven categories of ACP functions printed on 
the performance report. They are: 


Access/Deaccess 

These functions are: Access File for Read, Access 
File for Read/Write, Access File for Read/Write/ 
Extend, Deaccess -File, Connect Logical Link, and 
Disconnect Logical Link, and Close Qut LUN. 
Create/Delete 


These functions are: Create File, Delete File and 
Truncate File. 


Read/Write 

These functions are: Read Virtual Block, Write 
Virtual Block, Receive Message and Transmit 
Message. 

Directory 

These functions are: Find File Name in Directory, 
Enter File Name in Directory and Remove File Name 
from Directory. 

File Attribute 


These functions are: Read File Attributes and Write 
File Attributes. 


Extend 

This is the Extend File function. 

Other 

These functions are all ACP functions other than 
those listed above, such as: Unlock Block, User 


Magtape Control Function and Network Control 
Function. 
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Memory Residency 


The Memory Residency count is incremented each time a 
task successfully allocates memory for an initial task 
load or for a checkpoint read. 


CPU Timeslices 


A CPU Timeslice is the time between a Load Task 
Context event and a Save Task Context event, minus the 
idle time accrued during that period. Note that if a 
task issues a directive and the processor switches to 
kernel mode, the corresponding time in kernel mode is 
charged to the active task's CPU timeslice. Also, if 
an interrupt occurs while a task's context is active, 
the corresponding kernel mode time is charged to the 
active task's CPU timeslice. 


Initial Loads 
Initial Loads is the number of Initial Task Load 


events for the task. The USAGE times indicate the 
time it took the loader task to load the task; the 


WAIT times indicate how long a task's load request was 


in the loader task's queue. 
Checkpoint R+W 


Checkpoint R+W is the number of Checkpoint Read and 
Checkpoint Write events for the task. The USAGE times 
indicate the time it took the loader task to check- 
point (read or write) the task. (Note: the USAGE 
times do not indicate how long a task was check- 
pointed. This information appears under "Memory 
Times" on the task metric page.) 


DDnn Ovly Loads 


DDnn Ovly Loads is the number of overlay read (10.LOV) 
QIOS the task issued to device DDnn. 


DDnn QI10s 


DDnn QIOs is the number of logical QI0s a task issued 
to device DDnn. Please note the following caveats: 


- DDnn Ovly Loads is included in this count, since 


I0.LOV is a Logical block QI0. 
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- Task I0.RVB and I10.WVB (virtual) QI0s which are 
successfully and entirely mapped by the executive 
or FIl1ACP to I0.RLB and IO.WLB (Logical) QIOs are 
included in this count. : = 


- Task I0.RVB and I0.WVB (virtual) QIOs which are 
sent to FIl1ACP, and which are performed by F11ACP 
on behalf of the task (partially mapped, multiple 
transfers), are not included in this count. This 


logical block I/0 is charged to F11ACP. 


- The I0.ATT, I10.DET and I0.KIL QIOs are not included 
in this count. 


- Drivers for devices with the characteristic UC .QUE 
may directly process an I/0 request without the IRP 
being queued. This will cause an incomplete 
measurement of Usage and Wait times. (e.g. TT:) 


USAGE Times 


The USAGE times indicate how long a task used a resource. 


WAIT Times 


The WAIT times indicate how long a task was waiting for the use 
of a resource. 


SERVICE Times 


The SERVICE time is the USAGE time plus WAIT time which 
occurred for each resource request. Note that the minimum 
SERVICE time is not necessarily equal to the minimum USAGE time 
plus minimum WAIT time, since the minimum USAGE time may have 
occurred for a different resource request than the resource 
request which had the minimum WAIT time. The same applies to 
the maximum. 


ARRIVALS PER SECOND 


The mean task rate is the number of resource requests issued by 
a task divided by the task's elapsed time. It tells, from a 
task's point of view, the rate of resource requests issued by 


a task. The mean system rate is the number of resource 


requests issued by a task divided by the data reduction period. 
It tells, from a resource's point of view, the rate of resource 
requests issued by a task. 
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Resource Metrics 


For 


each 


resource used by a task, the following metrics are 


printed on the report: 
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Count 
The number of times a task used a resource. 
Total Time 


The total time during which a task used the resource 
(equal to the sum of all resource usage intervals). 


% Resident Time 
% Resident Time is (Total Time/Resident Time) * 100%. 
Minimum 


The smallest interval during which a task used a 
resource. 


Mean 


The arithmetic average of all resource usage intervals 
for a task. 


Maximum 


The largest interval during which a task used a 
resource. 


Coefficient of Variation 


The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 


% Resource 

% resource is the total time a task used the resource 
divided by the total time of the Data Reduction Period 
(total resource time available). 

Incomplete 

If the logfile does not contain a "complete" set of 
events needed to define an interval, MDR will tally 


the interval as an “incomplete". For example, if MDR 
reads a I/0 Done event from the logfile for a certain 
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task and device and there is no corresponding Get I/0 
Packet event for the task and device, MDR will regard 
the I/0 interval as an incomplete. Incomplete 
intervals can occur if COL starts data collection 
while an operation (interval) is already in progress. 


The only data recorded for incomplete intervals is the 
count; no timing information is computed since the 
information is not precise. 


Incomplete intervals are printed in lieu of the % 
resource metric if the /IC switch is specified. 


READING THE PERFORMANCE REPORT 5-11 


Chapter 6 


RESOURCES USED 
BY SPM-11M 


The purpose of this section is to give an estimate of the 
resources used by the COL and MDR tasks. 


Oe 


Q 
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RESOURCES USED BY COL 


CPU 


When a task metric hook is encountered, from 50 to 75 
instructions are executed at system level (PR=0, 
$STKDP=0) before returning to the main flow of the 
executive. 


System Pool 


When the COL task is inactive, about 115 words of 
executive space are used. This is accounted for by 
the hook points (3 words per hook), 4 words added to 
system common, 16 words added to the system stack and 
a dummy hook return routine added to SYSXT. 


When the COL task is activated, approximately 215 more 
words of system pool are used. 


Physical Memory 
The COL task occupies about 4K words of physical 


memory. The COL buffers (either in a static common or 
dynamic region) can vary from 0.5K words to 32K words. 
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1/0 Requests 


The COL task issues a FCS WRITE$ to write a buffer to 
disk; it issues a QIO$ to write a buffer to magtape. 
The rate of I/0 requests generated by COL depends on 
the system activity that COL is tracing. 


RESOURCES USED BY MDR 


Memory 


The code and static data of MDR requires varying 
amounts of memory depending upon which version is 
built. See the TASK IMAGE SIZE in MDR.MAP. 
Additional space is required for I/0 buffers and 
dynamic structures which are manipulated within MDR's 
virtual address space. MDR will automatically extend 
its virtual space as needed to accommodate these 
structures. Typically MDR will require an additional 
8KW for all the dynamic storage. 


Pool 


All MDR I/0 is singly buffered, and synchronous, 
minimizing the use of pool. 


1/0 


Each pass of MDR reads a single file and writes to the 
report file. During pass I the RESOURCE.TMP file is 
also being written. Terminal I/0 is used for command 
input, and error reporting. The DRS task will have up 
to 7 files concurrently opened for I/0. 
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Chapter 7 


SPM-11M USAGE NOTES 


ew TASKBUILDING COL 


COL must be taskbuilt using the baseline library 


L1,1,SYSLIB.OLB (which does not contain FCS routines with ANSI 
or big buffering). 


If COL is taskbuilt with the ANSI or big buffering FCS 
routines, its size may be greater than 4096 words. The result 
will be that when COL is run, it will not be able to create an 
address window (the error received will be COLMSG -- CANNOT 
CREATE BUFFER PARTITION OR ADDRESS WINDOW). 


did COL BUFFERS 


When COL starts up it copies three system lists to the logfile: 


ie TeRsy 
2) PCBs, 
3) DCBs-UCBs. 


There must be enough buffer space to store the largest of these 
three system lists, otherwise COL will print the error message 
COLMSG -- INFORMATION RECORD ALLOCATION FAILURE. 


Before COL is left to run unattended for long periods of time, 
COL should be run for 5 to 10 minutes under a typical heavy or 
peak system workload and the console terminal should be 
monitored for the occurrence of overflow errors, i.e., COLMSG 
-- BUFFER OVERFLOW. If buffer overflows occur, the buffer size 
for COL can be increased by using the /BF switch (see Chapter 
3. Section 33.2.2) 


Another cause of CUL overflows may be small disk file extent 
sizes. When COL attempts to write a buffer to the logfile, 
FIITACP may have to do an extend file operation before the 
actual data write can be done. The time it takes FI1lACP to 
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extend a file may be long, and COL may overflow as a result of 
this. To remedy this situation, two switches have been built 
into COL: 


fe) Initial File Size /IF 
0 Extend File Size /EX 


If an estimate can be made of the maximum logfile size before 
COL is run, it is best to preallocate all the logfile space via 
the /IF switch. In this case COL will not need F11ACP to do 
any extend file operations during its run and this may prevent 
overflows from occurring. 


P63 STATE OF SYSTEM AT COL STARTUP TIME 


When COL starts up, it copies the TCBs, PCBs, DCBs and UCBs in 
RSX-11M to the logfile. The MDR task later refers to these 
data structures to derive the necessary context for printing a 
performance report. 


To assure that MDR will have all the context it needs to print 
the report, you should insure that the following conditions are 
satisfied before starting up COL: 


(6) All tasks installed 


If you want to disable a task for data collection, 
that task must be installed when COL starts up. Al] 
tasks dynamically installed after COL starts will 
always be enabled for data collection. This means 
that all multiple copies of a multiuser task will 
always be enabled for data collection. 


0 All partitions set up 


If you want memory metrics kept for a partition, the 
partition must be set up 
(via SET /MAIN=XYZPAR :m:n:type) before starting COL. 


re) All drivers loaded 


If you want the I/0 metri 
tha anadtuwan mananina th 
LHe Urb iveel matay my cl 


before starting COL 


The MDR program is not capable of analyzing a logfile 
which contains task event records for an I/0 device, 
but no system configuration information for that 
device. To ensure that unusable logfiles are not 
created, no device driver database may be loaded while 
the task ...COL is active. 
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All devices mounted 


If you want the correct ACP taskname for a mounted 
volume to be printed on the performance report, the 
volume must be mounted before starting COL. Other- 
wise, MDR will print a "pseudo" taskname for the ACP. 


Example: If the device DKl: is mounted to the F11ACP 


task after data collection is in progress for COL, MDR 
will print the pseudo name DK1***ACP on the report. 


All checkpoint files allocated 
If you want the system metrics for checkpoint file 


usage, be sure to allocate all checkpoint files with 
the ACS command before starting COL. 
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7.4 TASKBUILDING MDR 

MDR will run on processors with or without hardware FPP (float- 
ing point processor) support. If your processor does not have 
hardware FPP, it must minimally have hardware EIS instructions. 
You must taskbuild MDR to reflect the type of hardware (FPP or 
EIS) on your processor. You can build MDR either overlaid or 


non-overlaid with both FPP and EIS versions. To build MDR, 
invoke the build command file: oa 


>@MDRT KB 


This command file will prompt you to build any of the four 
available versions: 


1. FPP support, overlaid 
2. FPP support, non-overlaid 
3. EIS support, overlaid 
4, EIS support, non-overlaid 
You can change certain MDR defaults by editing the taskbuild 
command file produced by MDRTKB.CMD. The MDRTKB.CMD procedure 
will prompt you for changing the defaults. The defaults which 
can be changed are: 
0 Number of lines per page in REDUCE.RPT file 
fe) Default values for /LI switch 
0) Default values for /SI switch 
9) Default magtape logfile density (/DE) 
0 Default value for /DM switch 


0 Whether MDR automatically spawns DRS 


Las NECESSARY UFD TO RUN MDR 


The intermediate files used by MDR will always be created in 
the directory SY:[current UIC]. Therefore to run MDR, this 
directory must exist, on a mounted Files-11 disk. 6 
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ty 


Te) MANUALLY EXECUTING THE DRS PASS 


MDR cannot determine whether DRS has completed successfully or 
with errors. If errors are likely in this pass (e.g., 
available disk space is minimal) manual intervention to execute 
the DRS pass may be desirable. MDR will issue instructions for 
this manual operation if either of the following two conditions 
are true: 


0 MDR is built with the GBLPAT which prevents automatic 
Spawn of DRS, or 


rc) The task ...DRS is not installed when MDR is running. 


Ted TASKBUILDING CLF 
Generally CLF need not be taskbuilt since it is supplied as a 
task image. However to change defaults or apply patches, the 
build command file is invoked: 
>@MDRTKB 
The defaults which may be changed are: 
0 default magtape density, and 
) default value of the /FCS:nn switch (if specified as 
FFES 
7.8 USE WITH LAYERED PRODUCTS 
SPM-11M inserts hooks into the RSX-11M executive at standard 
places where the executive does allocations and deallocations 
of resources. 
SPM-11M measures kernel CPU time by hooking the standard 
interrupt save ($INTSV, $INTSE, $INTSC) and system exit 
($DIRXT) points. 
If any layered product or user privileged component uses 
nonstandard techniques for resource allocation or interrupt 


entry, the SPM-11M measurements will be inaccurate. 


For example, DECNET uses a nonstandard interrupt save routine, 
which means the kernel CPU time measurement will be inaccurate. 
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The COL task sets a status bit (MS.SYS) whenever a system 
entrance occurs. When a system exit occurs, COL checks that 
MS.SYS is set; if not, then COL has seen a system exit event 
without a corresponding system entrance event. COL will then 
simply ignore the system exit event and not add any kernel time 
in to the running total. Thus if layered product software 
receives interrupts via nonstandard drivers, the kernel mode 
time accrued from such interrupts will be ignored by COL. 

7.9 REPORTING PROBLEMS AND ERRORS 


A Software Performance Report (SPR) is used to report problems, 
errors, or suggested enhancements concerning SPM-11M. 


Whenever possible, the following information should be 
submitted with the SPR: 


) A map of the failing component, 

fe) The MPB source file (TRACE.PAR), 

O The logfile on magtape (TRACE.LOG), 

O The faulty performance report (REDUCE.RPT), 
O The faulty CLF output file on magtape, and 
0) The faulty OVL output file. 


All magtapes will be returned. 
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Appendix A 


HOOK RECORD DEFINITIONS 


NOTE: All record offsets in this appendix 
are expressed in octal bytes. 


All record lengths are expressed in 
decimal bytes. 


HOOK RECORD DEFINITIONS A-1 


1.1 
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H$CDRP - CALL DIRECTIVE PROCESSOR 


LOCATION 
DRDSP.MAC 
After $EMTRP: :DIRSV$ 
After $DPLM2::MOV 
After 50$: MOV 
Follow MOV 


DATA COLLECTION 
Storage Dependencies - 


$TKTCB (Current Task TCB) 
$DICSV (Directive ID Code) 


Record Format - 


Hook I.D 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


DIC 14 


Record Length - 


14. bytes. 


(SP)+,R3 
R5,R2 
$HEADR ,R4 


HOOK RECORD DEFINITIONS 


Lt 
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1 


a 


H$RTSK - REQUEST TASK TO RUN 


LOCATION 
REQSB.MAC 
After 
After 
Follow 


DATA COLLECTION 


$TSKRP:: 


1s 
MOV R2,T.UCB(RO) 


Storage Dependencies - 


RO=TCB address 


Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Request UIC 14 


Record Length 


14. bytes. 


HOOK 


RECORD DEFINITIONS 


Owned 


Dee ee 


meer 


H$XTSK - TASK EXIT 


LOCATION 


DREIF.MAC 
After SCEXIT:: 
After 134$¢: 


Follow » ENDC ;P$$OFF 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB=TCB address 


Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Idletime 14 


Record Length - 


16. bytes. 


HOOK RECORD DEFINITIONS 


& 
. 
nN 


4.0 


4.1 


4.2. 
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1 


H$SCTX - SAVE CONTEXT OF TASK 


LOCATION 
SYSXT.MAC 
After RESCH: CLR 
Follow 73$: MOV 


DATA COLLECTION 


Storage Dependencies - 


¢TKTCB (Current Task TCB) 


Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Idletime 14 


Record Length - 


16. bytes. 


$RQSCH 
H.GARD(R3) ,R2 


HOOK RECORD DEFINITIONS 


5.0 H$LCTX - LOAD CONTEXT OF TASK 


Dak LOCATION 


SYSXT.MAC & 
After RESCH: CLR $RQSCH 
After 120$: MOV H.GARD(R2) ,RO 
Follow »ENDC 


Sad DATA COLLECTION 


5.2.1 Storage Dependencies - 


$TKTCB (TCB address of new task) 


ay are Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Idletime 14 
5.2.3 Record Length - m 


16. bytes. 
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ol 


a2 


aes 


H$USTP - UNSTOP TASK 


LOCATION 


REQSB.MAC 


After $EXRQN: :BIT PL2eORPR2lT 2S 0P 4 Tes r2t RO) 
Follow $EXRQU: :BIC #EZeSTPF2IT2 STP TS be RO) 


DATA COLLECTION 


Storage Dependencies 


RO=TCB address 


Record Format - 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


Record Length - 


12. bytes. 


12 
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7.0 H$QAST - QUEUE AST TO TASK 


71 LOCATION 


REQSB.MAC 
After $QASTT : :ADD #T.ASTL,RO 
Follow CALL $SETCR 
REQSB.MAC 


After $QUEXT:: 


Follow MOV R2,RO0 


Fae DATA COLLECTION 


Veeak Storage Dependencies - 


RO=TCB address 


7.2.2 Record Format - 


Hook I.D. 0 
Timestamp 2 
6 
12 


TAted Record Length - 


12. bytes. 


a 
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8.2. 
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ol 


3 


H$EXTK - EXTEND TASK IN PLACE 


LOCATION 
DREXP.MAC 
After $DREXP::TSTB T.10C(R5) 
Follow 71$: MOV R1,P.SIZE(RO) 


DATA COLLECTION 
Storage Dependencies - 
S$TKTCB=TCB address 


RO=PCB address 


Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
14 


Record Length - 


14. bytes. 


HOOK RECORD DEFINITIONS 


9.2. 
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el 


a2 


3 


H$QTRP - QUEUE TASK REQUEST FOR PARTITION 


LOCATION 
REQSB.MAC 
After  $TSKRP:: 
After 7$: 
Follow MOV R1,RO 


DATA COLLECTION 


Storage Dependencies - 


RO=TCB address 


Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 


Record Length - 


12. bytes. 


HOOK RECORD DEFINITIONS 
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10.0 H$QLDR - QUEUE TASK LOAD REQUEST TO LOADER QUEUE 
10.1 LOCATION 
. REQSB.MAC 
- Follow $LOADT::MOV $LDRPT ,RO 
‘ 10.2 DATA COLLECTION 
10.2.1 Storage Dependencies - 
R1=TCB address 
10.2.2 Record Format - 
Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
14 
16 
- 10.2.3 Record Length - 


HOOK RECORD DEFINITIONS 


ie are!) 


tek 


TLS 


be eer 


i rr aed 


Pies 3 
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H$GLDR - GET REQUEST FROM LOADER QUEUE 


LOCATION 


LOADR.MAC 
After $LOADR : :CALL $SWSTK ,40$ 


Fol] 


ow 10$: MOV R1,LDRTK 


DATA COLLECTION 


Storage Dependencies - 


R1=TCB address 


Record Format - 


Timestamp 


Taskname 


TI UCB Address 


(RAD50) 


12 


Record Length - 


12. 


bytes. 


HOOK RECORD DEFINITIONS 


12. 


2s 


12. 


Tes 


12s 


1 


2 


H$FLDR - FINISH LOADER REQUEST 


LOCATION 
LOADR.MAC 


After $LOADR : :CALL 


Follow 84$: 


DATA COLLECTION 


ae Storage Dependencies 


R5=TCB address 


at Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


12.2.3 Record Length - 


1/82 


12. bytes. 


CALL 


iz 


$SWSTK,40$ 
$SWSTK ,$LOADR 


HOOK RECORD DEFINITIONS 


13.40 


Loved 


L3e2 


lee ara 


Le are 


Iveu3 
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H$RLPR - RELEASE PARTITION 
LOCATION 
REQSB.MAC 
Follow $RLPAR: :MOV 


DATA COLLECTION 


Storage Dependencies - 


RO=TCB address 


Record Format - 


Hook ID 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


Record Length - 


14. bytes. 


HOOK RECORD DEF 


T.PCB(RO) ,R1 


12 


14 


INITIONS 


< 


14. 


14. 


14. 


14. 


14. 


0 


1 


el 


2 


14.2.3 
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H$QDRV - QUEUE I/0 PACKET TO DRIVER 
LOCATION 
DRSUB.MAC 
Follow $DRQRQ::MOV 
DATA COLLECTION 
Storage Dependencies - 
R1=IRP address 


R5=UCB address 


Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address TZ 
| UCB Address 14 
— 
20 


pu 
| IRP Address | 22 


Record Length - 


20. bytes. 


HOOK RECORD DEFINITIONS 


U.SCB(R5) ,R4 


15. 


15. 


Lo 


15. 


LS. 


LD.gidceo 
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e2 


H$GPKT - DRIVER GETS AN I/O PACKET 


LOCATION 
IOSUB.MAC 
After SGTPKT:: 


After 12ers 
Follow MOVB U.UNIT(R5) ,R2 


DATA COLLECTION 
Storage Dependencies - 
R1l=IRP address 


R5=UCB address 


Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
IRP Address 14 


Record Length - 


14. bytes. 


HOOK RECORD DEFINITIONS 


16.. 


16. 


16. 


LG. 


16. 


0 


1 


2 


ae 


ae 


H$IODN - I/0 DONE PROCESSING 
LOCATION 
ITOSUB.MAC 
Follow $I10DON: :MOV U.SCB(R5) ,R4 


DATA COLLECTION 


1 Storage Dependencies - 


R4= SCB Address 


2 Record Format - 


Hook I.D. 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


14 


16.2.3 Record Length - 
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14. bytes. 


HOOK RECORD DEFINITIONS 


17.0 H$IOFN - COMPLETE I/0 POST PROCESSING 


17.1 LOCATION 
IOSUB.MAC 
Follow $I0FIN:: 
17.2 DATA COLLECTION 


Lees Storage Dependencies - 


R3=IRP address 


17.2.2 Record Format - 


0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
IRP Address 14 


17.2.3 Record Length - 


14. bytes. 
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Pz 


18.0 


18.1 


1.8 


Pho 


LBs 2s 


LOs2% 
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1 


fd 


H$QAC1 - QUEUE I/0 PACKET TO ACP 


LOCATION 
DRQIO.MAC 
After $DRQIO: 


After FCXIT: 
Follow MOV U.ACP(R5) ,RO 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP address 


Record Format - 


Hook I. D. 0 

Pi 

Taskname (RAD50) 6 
TI UCB Address 12 
UCB Address 14 
20 


IRP Address 


18.2.3 Record Length - 


20. bytes. 


HOOK RECORD DEFINITIONS 


19.0 


19.1 


Poe2 


Ura er 


ie ey ara 


Ieee 
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H$QAC2 - QUEUE I/0 PACKET TO ACP 


LOCATION 
IOSUB.MAC 
After $GTPKT:: 
Follow 95$: 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP address 


Record Format - 


Hook I.D. 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


UCB Address 14 
Function Code 16 


20 


| IRP Address | 22 


Record Length - 
20. bytes. 


HOOK RECORD DEFINITIONS 


£04 


20%. 


20 4 


os 


20. 


20 62%.3 
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1 


ot 


H$GACP - ACP GETS AN 1/0 PACKET 


LOCATION 


FIOSUB.MAC (F11ACP) 
After ~-GTPKT:: 


Follow 10$: MOV 


R1.,.TOPKT 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP Address 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


IRP Address 


TI UCB Address 


12 


14 


Record Length - 


14. 


bytes 


HOOK RECORD DEFINITIONS 


21.0 H$SOVLY - LOAD OVERLAY FROM DISK 


reel ere LOCATION 


DRQIO.MAC 
After $DRQIO:: 
After 10$: 
Follow BNE IEOVR 


212 DATA COLLECTION 


21.2.1 Storage Dependencies - 


R4=<Address+2> of Overlay Relative Block Number 


21.2.2 Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Relative Block Number 14 


21.2.3 Record Length - 


14. bytes 
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22.0 


22.1 


22.2 


ae ee 


Lorene 


Var Say ee 
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H$SYEN - SYSTEM ENTRANCE 


LOCATION 

SYSXT.MAC 

After $DIRSV:: 

Follow MOV SP,@$HEADR 
SYSXT.MAC 

After SINTSV:: 

Follow MOV SP,@$HEADR 
SYSXT.MAC 

After SINTSC:: 


Follow MOV SP ,@$HEADR 


DATA COLLECTION 


Storage Dependencies - 


None 


Routine - 


Timestamps system entrance time $BSTIM. 


Record Format - 


None 


HOOK RECORD DEFINITIONS 


ods 


23. 


23. 


ya 


23% 
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0 


it 


H$SYXT - SYSTEM EXITS TO USER TASK 


LOCATION 
SYSXT.MAC 
After $DIRXT:: 
Follow 5$: 


Storage Dependencies - 


None 


Routine - 

Copies current clock time, subtracts system entrance 
time ($BSTIM), and adds the resulting delta time to 
the total system time $TSTIM. 


Record Format - 


None 


HOOK RECORD DEFINITIONS A-24 


24. 


24. 


24. 


24. 


24. 


24. 
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1 


H$EIDL - ENTER EXECUTIVE IDLE LOOP 


LOCATION 
SYSXT.MAC 
After RESCH: 
After 30$: 
Follow BNE 10$ 


DATA COLLECTION 


Storage Dependencies - 


None 


Routine - 
Copies current clock time, subtracts the system 
entrance time ($BSTIM), and adds the resulting delta 


time to the total system time $TSTIM. Timestamps idle 
entrance time $BIDLE. 


Record Format - 


None 


HOOK RECORD DEFINITIONS A-25 


25.0 H$XIDL - EXIT EXECUTIVE IDLE LOOP 


2561 LOCATION 


SYSXT.MAC 

After RESCH: 

Follow 46$¢: CLRB (R1) 
SYSXT.MAC 

After $FORKO:: 

Follow BCC SINTXT 


25.2 DATA COLLECTION 


25.2.1 Storage Dependencies - 


None 


Copies current clock time, subtracts the idle loop 
entrance time ($BIDLE), and adds the resulting delta 


time to the total idle time $IDLE. Timestamps system 
entrance time $BSTIM. 


25.2.3 Record Format - 


None 
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2620 


261 


2622 


Vale eras 
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H$USER - USER INFORMATION HOOK 
LOCATION 
QPDRV.MAC 
Follow QPINI: 
DATA COLLECTION 
Storage Dependencies - 


R1=IRP address 
R5=UCB address 


HOOK RECORD DEFINITIONS 


264242 


1/7 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


Function Code 


LUN 


QIO Parameter 1 


QIO Parameter 2 


QI0 Parameter 3 


QIO Parameter 4 


QIO Parameter 5 


QIO Parameter 6 


Record Length - 


28. bytes. 


HOOK RECORD DEFINITIONS 


12 


14 


16 


20 


22 


24 


26 


30 


ae 
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MPB DEFINITIONS 


Monitor Parameter Block 


The Monitor Parameter Block (MPB) is the data structure which 
contains the measurement parameters. These measurement 
parameters are defined by invoking the procedure @SMPGEN.CMD, 
which produces: 

O The binary MPB file (filename.MPB), 

O The source MPB file (filename.PAR), and 

O The MPB saved answer file (filename.CMD). 


The COL task reads the MPB and initializes its databases from 
the MPB. 


The length of an MPB in bytes is M.LGTH (defined by MPBDF$ in 
HKMAC .MAC). 


The MPB has the following format and contents: 


Parameter Offset Size(wds) Values 
MPB ID word (I$MPB) M.PID 1 I$MPB 
Measurement label M.LABL ae 

Buffer Type M.BTYP 1 DYNAMIC=0 

STATIC=1 

Buffer Count M.BCNT 1 

Buffer Size (bytes) M.BSIZ 1 

Buffer Size (64b bik) M.BS64 i 
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Parameter 

Buffer Partition Name 
SYS Partition Name 
Buffer Partition Addr. 
Buffer Partition Size 
Buffer Partition Flags 


Measurement Mode 


Sample Count (Buffers) 
Sample Interval Mag. 
Sample Interval Units 
Repeat Count 

Repeat Interval Mag. 
Repeat Interval Units 
Hook Bit Table 

I/O Selection Word 
Other Devices Sel. Word 
Device Class Mask 
Device Selection Mask 
Sys. Metrics Samp. Int. 
Sys. Metrics Partition 
Sys. Metrics Device 

TI Filter Device 

TI Filter Device Num. 
MPB Validation Word 
Task Selection Mask 


Task Selection Table 


1/82 


Offset 


M.BPAR 
M.BPNM 
M.BPAD 
M.BISZ 
M.BFLG 


M.MODE 


M.SCNT 
M.SINT 
M. SUNT 
M.RCNT 
M.RINT 
M.RUNT 
M.HTBL 
M.IOS 

M.OTHR 
M.CW1M 
M.CW1S 
M.SAMP 
M.PART 
M.DEVC 
M.TIDV 
M.TINM 
M.VALD 
M.TKS 


MT EBL 


MPB DEFINITIONS 


Size(wds) 
2 


Z 


128. 


Values 


MANUAL=0 
AUTOSTOP=1 
REPEAT=2 


P$$VER 


Appendix C 


INFORMATION RECORD 
DEFINITIONS 


Information Records 


The Information Records provide system context data which can 
be correlated with the Hook Records to identify tasks, 
partitions, and 1/0 device-units. 


In addition, there are Information Records which capture 
essential data when COL starts and stops data collection. 


For lengths of the following records, see the macro IBDEF$ in 
HKMAC .MAC. 


I$SYS - System Common Information 


I$Sys 0 


Initial Pool Size 2 


$FMASK 4 
$FMASK+2 6 


$HFMSK 12 


Sys. Dev. UCB Address 14 


— 
jon) 
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I$TCB - Task Control Block 


0 
I$TCB Record Size 2 
TCB Address 4 
TCB Contents 6 

I$PCB - Partition Control Block 

0 
I$PCB Record Size 2 
PCB Address 4 
PCB Contents 6 
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I$DCB - Device Control Block 


I$DCB 0 
I$DCB Record Size 2 
DCB Address 4 
DCB Contents 6 
I$UCB - Unit Control Block 

I$UCB 0 
I$UCB Record Size 2 
UCB Address 4 

6 


UCB Contents 
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I$CKP - Checkpoint File Information 


I$CKP 0 
CKP. File Device UCB Addr. 2 
CKhPs File Size 4 


I$TMR - Start Data Collection 


1/82 


=) 
Peni | 
Pence | 
Pein | 
Peer | 
Pecos | 
Peco | 
Praia | 
Praeereee | 
High KW11-P Time 22 

24 


Low KW11-P Time 


INFORMATION RECORD DEFINITIONS 


I$STM - 
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Stop Data Collection 
System Time (Year) 
System Time (Month) 
System Time (Day) 
System Time (Hour) 
System Time (Minute) 
System Time (Second) 
System Time (Tick) 
Ticks Per Second 
High KW11-P Time 
Low KW11-P Time 
CPU Kernel Time (High) 
CPU Kernel Time (Low) 
CPU Idle Time (High) 
CPU Idie Time (Low) 


Device Usage Time (High) 


Device Usage Time (Low) 


INFORMATION RECORD DEFINITIONS 


10 


12 


14 


16 


20 


22 


24 


30 


oe 


34 


36 


40 


Appendix D 


SYSTEM METRICS RECORD 
| DEFINITIONS 


System Metrics Record 

The System Metrics Record contains data which represents the 
system-wide usage of the CPU, pool, a selected memory 
partition, checkpoint file space, and a selected device. 


The length of the S$MET record, in bytes, is S$METL which is 
defined by SMDEF$ in HKMAC.MAC. 
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a 
Pe mre —d: 
faerie | 
CPU Kernel Time (High) 6 
CPU Kernel Time (Low) 10 
CPU Idle Time (High) 12 
CPU Idle Time (Low) 14 
# Free Pool Nodes 16 


Total Free Pool Space (bytes)} 20 


Smallest Pool Node (bytes) 22 
Largest Pool Node (bytes) 24 
Poorer | 
Soca 
Total Space Used (32W biks) 32 
Perens | 
Pecan eee | 
UCB Address of Device 40 
Device Usage Time (High) 42 
Device Usage Time (Low) 44 
Free Disk Blocks (High) 46 
Free Disk Blocks (Low) 50 


SYSTEM METRICS RECORD DEFINITIONS 


a 
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LOGFILE FORMAT 


1.0 DISK LOGFILE FORMAT 


A logfile on disk is a Files-11 file with the following format: 


VBN 
1 
BUFFER 
#1 
N 
N+1 BUFFER 
#2 
2N 


BUFFER 
#M 
M*N | 
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Each BUFFER has the following general format (byte 
offsets): 


x$xxx is I$, H$ or 
S$ record ID. 
See appendices 
A, B, C and D. 


ee, 
TE, Sp 
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2: 


All BUFFERS are the same length. The BUFFER size in 512B 
blocks is derived from the BUFFER size in bytes which is 
stored in the MPB in BUFFER #1: 


BUFFER #1 Format (byte offsets) 


" 
Overflow Count 2 
ISMPB 4 Note: 
ISMPB is the lst record; 
I$SYS is the 2nd record; 
x$xxx is I$, H$ or S$ 
record ID. 
See appendices 
A, B, C and D. 
BUFFER Size (bytes)}| 4+M.BSIZ 


U/, 
Unused Space 
Vi ; 


BUFFER size (bytes 


BUFFER size (blocks) = ETD 
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2.0 MAGTAPE LOGFILE FORMAT 


A magtape can contain one or more logfiles. Each BUFFER is 
terminated by an IRG. Each logfile is terminated by a tape 
mark (EOF). The magtape is terminated by a double tape mark 
(EOF EUF). Each BUFFER has the same format as for disk. 


BUFFER 
#1 


BUFFER 
#M1 


end of logfile #1 


BUFFER 
#1 


BUFFER 


#Mn 
end of logfile #n 
end of tape 
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3.0 FCS LOGFILE FORMAT 


The CLF utility task can be used to convert a logfile from the 
formats specified in section 1.0 and 2.0 to a file containing a 
stream of variable length FCS records. Each FCS record 
contains one record of type H$xxxx, I$xxxx or S$xxxx. The 
first word of each record contains the record ID, H$xxxx, 
TSXXRX. Or SSRXKX. The record formats are specified in 
Appendices A, B, C and D. 


See Chapter 3, Section 3.2.5 for using CLF. 
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Appendix F 


EXAMPLE 
PERFORMANCE REPORT 
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Appendix G 


“EXAMPLE SMPGEN 


DASH TROPEGYS 

°SET /UICeLLls2] . 

“OSMPGEN 

mere Software Monitor Farameter GENeration command file xxx 
ate Version 2 ¥xx 

an 


“tCargright (C) 1981 Disgital Eeuirment Corrorationys Maynards Mass. 
oy 


wee ee DE ce > wee 


oy HE ee 


Initialize default rarameters 

READ SAVED ANSWER FILE FOR DEFAULT ANSWERS? CY/NI3 

Gelect warameter category, tyre “esc> for hele 

ENTER PARAMETER CATEGORY CST 

LEGAL PARAMETER CATEGORIES ARE : 
HOOK TASK MODE LABEL 
BUFFER DEVICE SYSTEM DONE 


i si te 


ENTER PARAMETER CATEGORY [£S]! HOOK 
Select/deselect nook roints 


CFU USAGE HOOKS? CY/NI; Y 

MEMORY USAGE HOOKS? CY/NI: Y 

I/O DEVICE USAGE HOOKS? CY/NI: Y 

USER INFORMATION HOOK? CY/NI: Y 

LOAD QVERLAY HOOK? CY/NI: N 

CALL DIRECTIVE FROCESSOR HOOK? CY/NIJ: N 


Select esarameter catesorys tyre “esc? for hele 
ENTER PARAMETER CATEGORY CSI]? BUFFER 
Setup buffer management rarameters tyre “ese? for helr 


ENTER BUFFER TYPE COiDYNAMIC] CS Ri0-7]% 

ENTER NAME OF BUFFER MAIN (SYS) FARTITION CISGENJ CS Ri0-6]: BUFFAR 
ENTER NAME OF BUFFER COMMON/REGION CISTRCPARI CS Ri0-4]: 

ENTER NUMBER OF BUFFERS CI Ri2.-8. Di2.]: 4 

ENTER RUFFER SIZE IN Si2B BLOCKS CD Rii.-16, 038.13 


See a ee 


Select ture ¢esces for hele 


La 
oc 
eel 
Hy 
5 
~ 
By 
au 
3 
uy 
3 
a 
ui 
ts 
is 
18) 
ce 
it) 
UL 
Oo 
3 
it 


ENTER PARAMETER CATEGORY CS]: MODE 


flefine data collection moder, tyre “esc for helr 


De cy war or HE rae o> 


ENTER MODE COSMANUALI CS R?30.-8.];3 
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Ob Mah IS ee sae ee 


BE FE vere ee HE ae er ee EE EME eae BE Me EE RM RE RHR MH KR KRM RR K KKK LR ERE 


Select paerameter catedorys tyre “ese? for help 
ENTER FARAMETER CATEGORY [CS]? TASK 
Select/deselect tasks to be traced 


tO YOU WANT TO TRACE ALL TASKS? CY/NI? 
NO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? CY/NI? Y 


Enter one teskname rer line. Terminate list by <CRz, 


ENTER NAME OF TASK NOT TO TRACE CS1$ TKTN 
ENTER NAME OF TASK NOT TO TRACE [CS]3 ...RMD 
ENTER NAME OF TASK NOT TO TRACE £CS13 RMDEMO 
ENTER NAME OF TASK NOT TO TRACE CSI! FiiMmMSG 
ENTER NAME OF TASK NOT TO TRACE CS]: MTAACF 
ENTER NAME OF TASK NOT TO TRACE CS]? ...0M0 
ENTER NAME OF TASK NOT TO TRACE CSI: MCR... 
ENTER NAME OF TASK NOT TO TRACE CS7: ...0CL 
ENTER NAME OF TASK NOT TO TRACE CS1? ...MOQU 
ENTER NAME OF TASK NOT TO TRACE CS]! ...MCR 
ENTER NAME OF TASK NOT TO TRACE £S1! ERRLOG 
ENTER NAME OF TASK NOT TO TRACE CS1t FMT... 
ENTER NAME OF TASK NOT TO TRACE CS1$ COT... 
ENTER NAME OF TASK NOT TO TRACE CSI! ...CA. 
ENTER NAME OF TASK NOT TO TRACE CSIt ...INS 
ENTER NAME OF TASK NOT TO TRACE CS1: QMG...- 
ENTER NAME OF TASK NOT TO TRACE CS]! FRT... 
ENTER NAME OF TASK NOT TO TRACE CSI: TT11 
ENTER NAME OF TASK NOT TO TRACE CSI! TT12 
ENTER NAME OF TASK NOT TO TRACE CS1% ...-AT. 
ENTER NAME OF TASK NOT TO TRACE CSIJ% AT.T17 
ENTER NAME OF TASK NOT TO TRACE CSI? ...INI 
ENTER NAME OF TASK NOT TO TRACE CS]: ...HEL 
ENTER NAME OF TASK NOT TO TRACE CS1! ...BYE 
ENTER NAME OF TASK NOT TO TRACE [S73 


Select rarameter categoryus ture “esc> for hele 


ENTER FARAMETER CATEGORY CS73 DEVICE 
[NO YOU WANT TO COLLECT DATA FOR ALL DEVICES? CY/NI? 


Select device tyres to be traced 

TRACE DISK (HIRECTORY DEVICE) I/0 ACTIVITY? CY/NIT: Y 
TRACE TAFE (SEQUENTIAL DEVICE) I/70 ACTIVITY? CY/NIT? 
TRACE TERMINAL I/0 ACTIVITY? LY/NI: 

TRACE ALL OTHER DEVICES I/0 ACTIVITY? CY/NI? 

Select parameter category, ture “ese> for help 

ENTER PARAMETER CATEGORY CS]! SYSTEM 


Select system metrics 


10 YOU WANT THE SYSTEM-WIDE METRICS? CY/NI]3$ Y 
ENTER SYSTEM METRICS SAMPLING INTERVAL (SECS) CD Rti15.-28800. 240.1! 120 
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Select parameter category, ture sesc» for helr 

ENTER FARAMETER CATEGORY CSJ: LABEL 

[efine 1 to 63 character label strings tyre “esc= for hele 
ENTER MPE LABEL CS Ri0-431: This is a Sample SMPGEN. 
Select parameter catedoryr tyre ¢ese> for helr 

ENTER FARAMETER CATEGORY £5]: DONE 


Write saved answer file and rarameter source file 
Enter <ese> if no outeut file is desired 


ee ee eS et i 


ok ENTER NAME OF SAVED ANSWER FILE COSTRACE.CMDI CS1: SAMPLE.CMD 

“ ENTER NAME OF FARAMETER SOURCE FILE CIS TRACE.PARIJ CS]! SAMFPLE.FAR 
>MAC SAMPLE=HKMAC, SAMFLE.FAR 

2TKE @PARBLD 

DPIP SAMPLE. OBJ+X*/DEsPARBLD. CMD? X 

2@ EOF > 


“COL SAMFLE=SAMPLE 
COL -- PERFORMANCE MONITOR INITIALIZED 
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Appendix H 


EXAMPLE INSTALLATION 


“ASN DROS=SY3 

“SET /UIC#C1192] 

SUFD SYiC11s27 

“FLX =MM3C11l°2]7FMONCFY.CMD 
“QPMONCFY 


“&k IS SOURCE DEVICE A MAGTAFE? ECY/NI:3 Y 

ok IS DESTINATION DEVICE A MAGTAFE? CY/NI3 N 

oe ENTER SOURCE DEVICE (ODN?) CSI MM: 

“* ENTER DESTINATION DEVICE (DOIN?) CS13 DRO: 

ok TS DRO? MOUNTED? CY/NI: Y 

my 

“$ PLEASE SPECIFY THE GROUP ANI) MEMBER NUMBERS. OF THE SOURCE KIT DIRECTORY. 
oe THE ORIGINAL KIT DISTRIBUTION IS IN DIRECTORY Ciiy2], 

oo 

ok ENTER GROUP NUMBER OF SOURCE KIT DIRECTORY CO Rti-377 [t1113 

Ow ENTER MEMBER NUMBER OF SOURCE KIT DIRECTORY CO Rti1-377 D2! 

me 

“> PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE DIRECTORY TO WHICH 
“* THE SFM-11M KIT FILES WILL BE COFIED. 

a 

“Kk ENTER GROUP NUMBER OF TARGET DIRECTORY CO Rii-3773: 11 


“x ENTER MEMBER NUMBER OF TARGET DIRECTORY CO Rii-3771: 2 

“SET /UIC=C1il:2] 

oFLA DROS/RS=MM3 Cit» 2ISMPGEN.CMD,SPM.DOC/IO 

eFLX DROS /RS/-RW=MMi Cit» 27HKMAC. MAC» FMONSLFE.CMI/D0/-RW 

“FLX DRO? /RS/-RW=MM3 Cit, 2IDRDSF.CORsDIREIF.COR,SYSXT.COR/DO/-Rw 
“FLX DROV/RS/-RW=MMiC1is 2IDREXF.CORrIRQIO,COR» IOSUB,COR/DO/-RW 
“FLX DROS/RS/-RW=MM3C1L»27L0WCR.COR,SYSCM.COR/I0/-RW 

“FLX DRO? /RS/-RW=MMS Cit» 27REQSE.COR»LOADIR.COR/DO/-~RW 

“FLX DRO? /RS/-RW=MM3 C11. 270RSUB,.COR/IO/-RwW 

oFLX DROS /RS/-RW=MMS Cit, 2]FMONFAT. CMD, FIOSUB,.FAT/LO/-RW 

“FLX DROS/RS/-RW=MMSCils2ICOL.OLB,sCOLELD.ODL + FMONELDD.CMD/DO/-Rw 
“FLX DROS /CO/RS/BL{60./-RW=MMiCil»2ICLF.TSK/DO/-RwW 

7FLX DROS /CO/RS/BLI75./-RW=MMiCil,s2I0VL.TSK/DO/-RKW 

“FLX DROS/CO/RS/BLI175./-RW=MMiCii»210RS.TSK/DO/-RW 

eFLX DRO?/RS/-RW=MMS CLL, 2ICLF. MAPS ORS. CMD» MURTKE.CMD/DO/-RW 
“FLX DROS/RS/-RW=MMSC1iis2]0VL. MAP, OVL.OLB/DO/-RW 

“FLX DROS /RS/-RW=MMi CLL,» 2IMDREIS.OLBsMDURFFF.OLB, DRS. MAF /DO/-RwW 
7% APPLY CORRECTIONS TO EXECUTIVE SOURCES? CY/N1i Y 

=ASN SY3=SRE 

ok IS THIS AN RLOI/RLO2 SYSTEM GENERATION? CY/N1$ 

eSET /UIC=C11710] 

ePIP SRIRSXMCO.MAC/AF=C1ii»27HKMAC. MACS 

SSLF @C11*27DR0SF,COR 

°SLP @Cils2]KEQSB.COR 

>SLF @E£L1s21SYSXT.CurR 

“SLP @CiLi»s2]0REIF.COR 

eSLF @£1i,2]0REXF.COR 

“SLE @Cils»2I7LOADR.COR 

“SLP @C11l,27DRQI0.COR 

*SLP @Cily27I10SUB.COR 

*SLF @Cils2I]SYSCM.COR 

SSLP @C1il»27LQWCR.COR 

“SLP @Cii»2]DRSUB.COR 

7% APPLY PATCH TO FLI1ACF DISPATCHER MODULE (FIOSUB)? CY/NI$ Y 
=INS $PAT 

“SET /UIC=Cit,2] 

“MAC FIOSUB.FOB=HKMAC.MAC»FIOSUB. FAT 

“LER FIOSUB.OBJ$1=SRiC1,24]FCP/EX?FIOSUB 

*PAT FIOSUB.OBJ#2=FIOSUB.OBJ$1/CS3073710»F IOSUB.FOR/CS30146023 
7 WAS THE CHECKSUM SUCCESSFUL? LCY/N]: Y 
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“SET /UIC=C1924) 
SLER SRiFCFE/RP=Cil,»2IFIOSUB. ORY: 2 
Module °FIOSUB*® rerlaced 


SREM os +FAT 

“ASN =SR3 

“SET /UICHLCLLs 2] 
2@ SEOF> 


oPIF MOREIS.OLBsx/ne 


»SET /UIC=020072003 
=@SYSGEN 
MF 


RSX-11M V4.0 BL32 System Generation FHASE I -- version 1.53 


21-JAN-82 10358308 
Big disk distribution kit 


3. To vou want to inhibit execution of MCR commands? CY/NI? 
4. Have you made a cory of the distribution kit? LCY/NI]i Y 
3+ Are you generating a marred system? CY/NI3 Y 

7, Use an inrut saved answer file? CY/N]3 Y 

8. Name of input saved answer file CD3 SYSSAVED.CMDIJ CS? 


ste 36 HE ME HE He ee we 
f 


Fhase I input saved answers 

created om 19-JAN-82 at 09'45:53 

by SYSGEN version 1.53 

are from file DROi£200,200ISYSSAVED,.CMD; 2 


ves tan ses wee 


10, Name of outrut saved answer file [Ci [RO:£200;200]SYSSAVED.CMD] [S]3 


Fhase I outeut saved answers created in file [IR0!£200,200]SYSSAVED.CMDZ 


1i. Use saved host configuration? LY/NI: Y 

12. Use saved rerirheral configuration? CY/N]$ Y 

Shir end of section (E0S) breakroints? CY/NI]:3 Y 

14. Skire end of execution (EOX) breakroints? CY/NI: Y 
15. Clean ue files from previous GENS? LY/NI? Y 

16. Chain to Fhase II after Fhase I completes? CY/N]! Y 


LD wr 26 2 3 96 HEE Se ee ee HE ee 
hm 
il 
* 


ET /UIC=Cisi] 
“PIF Cls207RSXBLOD.CMDs &/DE/NM 
~PIP Cle Q4IRSXBLD.CMDF*/DE/NMs TTORVBLEGX 
“PIP CisSOISYSVMR. CMDs X/DE/NM»CirS4ISYSUMRGK 
“PIP Ciis2O]k OBJsk/DE/NM ek. UDCH Hee, ICRP Kok, TLSS RK. POSH 
PIP Clis24]&. OBJSX/DE/NM eK, UDCH KR, ICRI RPK IDSI ROK. TTYG KK POSER 
OPIP Clis3014.LSTSS/DE/NMy Cite Z4Iek.LSTIX 
SPIP CileLOIRSXMC. MACs &/DE/NM» ICTABs &+£2007 200]SGNFARM. CMDS X 
“PIP £200» 200]RSXBLD.CMIF&/DE/NM»TTORVBLIG* 
*PIP SYSCil»20]RSXASM. CMDs X/DE/NM» RSXDRVASM$ Xe £12) 20]7MCRSETASMGX 
oPIF SYiCils24IRSXASM.CMDGX/DE/NMs RSXDRVASM$ X9L12124IMCRSETASMIX 
oPIP /FR 


DRO: has 86205. blocks freer 45475. blocks used out of 131680. 
Largest contiduous space = 55911. blocks 
6648. file headers are freer 1451. headers used out of 8099. 


*SET /UIC=£Cii+s10] 
Py 
Target configuration 


a 
? 


a 
ane 
oar 

“9 


1 6.2 EXAMPLE INSTALLATION 


Frocessor.441/70 Memory Size: 320K sMarred SustemiRSX-11M 


ee 


Gwitch Register 
Fleating Foint Frocessor 
Extended Instruction Set 
Farity Memory 
teche Memory 

Host confisuration 

Executive 0@tions 


Terminal Oriver ortions 


System Ortions 


TRInk ims eee 
End of Executive ortion generation at 11201313 on 21-JAN-82 
Feripehera) configuration 


Farameters arrearing in seuare brackets Cy wade’. 3n 
specified for the first controller of 4 rarticular 


if the indicated ortion is present on the target 
The default “for loadable drivers has been set to 
for tne first comtroller of the srecified 

A/t and Laboratory devices! None srecified 

Interrerocessor communication devices: None srecified 

Unit record devices} None srecified 


fisks: DR 


Teres: MM 


Non-rhysical (rseudo) devices! CO» NL» TI» Cle LEr SY 


Terminal interface devices! Yl» YZ 


ser Gd Gh Oh en ae ae Or wen wee ae wer ae “Oe sen “OF ar “Oh Or ee eh ee “a> er > cer “er nar “8D er “By “ED wee “ae wen “Er sen ser nen “Or ey nae nae sor ~ar wo 


“SET /UIC=0C1224] ! Creating TTDRVBLD.CMD 
=SET /UIC=Cil,10] 

; End of interrurt vector area has been set to 400 
Dy 

, 

+ Create Executive build files 


Duar 
g 


SRIF RSXMC.MAC=SYSRSXMCO.MAC/AP 


“ 
* 
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Faragmeters arrearing in earentheses "4ss+)' only meed be crecified 


To override this setting enter R (resident) as the first esremeter 


SN SY?=SLB3 


Start of Executive assembly at 11304337 on 21-JAN-82 


rear 


wey 
“SET /UIC=C11»24] 
o>MAC @SYIRSXASH 


End of Executive assembly at 11124531 on 21-JAN-82 


; 
; 

By 
; 
* Start of MCR (subset) assembly at 11324331 on 21-JAN-82 

»SET /UICS#012+24) 

»MAC @SYSMCRSETASM 

mF 

“3 End of MCR (subset) assembly at 11327302 on 21-JAN-82 
3 5 

ha 
> Start of device drivers assembly at 11327303 on 21-JAN-82 

oF 

SSET /UIC#=£11+524] 

=MAC @SYSRSXDIRVALM 

2g 

“3 End of Device drivers assembly at 11336!54 on 21-JAN-82 


rae 

SASN =LAG 

9 

=>) Prepare for task building 


SET /UIC#£1:24] 

PPIF RSXL1IM.,OS=Ciis24]%.0BJ 

SPIF TTORV,OBRJ=Cil»243x.TTY 

“LER RSXLIM/CRI100.$960.2128,=RSX11M.0BS 
SLBER TTURV/CR?30.2256.°64,=TTURY 

oPIF /NV=CLi,10IRSXBLD.CMD 

CPIP ChLlislLOIRSXBLE.CMIs X/DE/iM 

we 

oe Clean-ure extraneous abJect files 


we 
“PIP RSXLIM.OBS#*/DE/NMs TTURV,OBJ# Ks Cites 247k. OBJ Ke Kk, TTYEE 


End of SYSGEN ehase I at 11:39:52 on 21-JAN-82 
~~ Chaining to C200,/200I1SYSGEN2.CMD 


LD > ar ee we 


ET /UIC=£2002200] 


RSX-11M V4.0 BL32 System Generation Fhase II -- version 1.50 


21-JAN-82 11339254 


Bigs disk distribution kit SYSGEN version 1.53 for RSX-11M BL32 


Continuation from SYSGEN FHASE I done on 2i-JAN-@82 at 11339248 


Fhase II ineut saved answers 

Created on 19-JAN-82 at 11213:35 

by SYSGEN version 1.50 

are from file DRO$£200+200]SYSSAVEL.CMII52 


ss “GP ee “Od er er wee ee “eb ae “GP ee Wer OP ae OP ww 
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»o) Fhase II output saved answers created in file DRO?C200»200I)SYSSAVED.CMD323 


oy 


>ASN SYS=LBE 
>PIP /FR 


DRO? has 79853. 
Largest contisuous space 
file headers are freer 


4550. 


My 
oy 


=SET /UICSC191) 


blocks free» 


51827. 
SS911. blocks 
1549. headers used out of 8099, 


an 
=o Start of library build at 11240317 on 21-JAN-82 


SPIF LBSANSLIB.OLB/NV=LB‘SYSLIE.OLB 


*LBR LBS ANSLIE/RP=SYi3FCSMTA 


Module 
Module 
Module 
Module 
Module 
Nodule 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 
Module 


Module 


LpeZ 


*ANSPAL® 
"ASSLUN® 
“BIGRUF® 
"CLOSE ° 
"CONTRL*® 
“CREATE® 
“DIRECT® 
*FCSTYF® 
"GET . 
*GETSQ ° 
"OPEN ° 
“OFENR ° 
"OFFIL ° 
“OPFNB ° 
“PARSFN® 
"POINT ° 
"PUT . 
"FUTSQ ° 
*ROWAIT® 


"RETADR® 


“"RSTFOB® 


*RWELK ° 
"RWLONG* 
"WATSET® 
“WIWAIT® 


"WIWATDS® 


rerlaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
replaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
rerlaced 
replaced 
rerlaced 
replaced 
rerlaced 
rerlaced 
replaced 
rerlaced 
replaced 
rerlaced 
rerlaced 


replaced 
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blocks used out of 131680, 


“SET /UIC=C1224] 

>PIP SYIMCR. ORIJ/NV/NM=012:243%.,0BJ 
“LER SY3MCR/RP=SYSMCR,.OBJ 
Module “[V20V ° rerlaced 
Module °SFSOV ° replaced 
Module "STSUB ° rerlaced 
Module "SX10V ° rerlaced 
Module "SX20V ° rerlaced 
Module "°SX30V ° rerlaced 
Module °SX40V ° rerlaced 
PIP SYI{C12:24]%,.OBJ3 k/TIE SNM 


End of library build at 11346816 om 21-JAN-82 


Start of Executive task build at 11346317 om 21-JAN-82 


nee ae er ae ee 


>PIP Cis341k. ke K/TE/NM 
STKE @LESRSXBLD 


End of Executive task build at 11348316 on 21-JAN-82 


Start of system image creation at 11348216 on 21-JAN-82 


sae ee ee ee ee ww 


SET /UIC#C1954] 
“PIF RSXL1M.SYS/CO/NV/BL!498.=RSXL1M.TSK 


End of system image creation at 11348320 om 21-JAN-82 


Start of full durlex terminal driver task build at 112348220 on 21-JAN-82 


SSET /UIC=01224) 
STKE @LBS TTDRVBLD 
Pa 

> End of full dgurelex terminal driver task build at 11348347 on 21-JAN-32 
oe 

’ 

> Start of loadable driver task build at 11:48:47 on 21-JAN-82 
md 


STKB @SY!CODRVBLD 
>TKB @SY!DRDRVBLD 


Start of common block task build at 11349332 on 21-JAN-82 


Build the ANSLIB flavor of the FCS resident library common 


eo 


§ 
a 
>3 Creating the task build .CMD and .ODL files in SY$f1:24] 
29 

T 


KB @SYiC1,24]FCSRSiBLD.CMD 


s, 
oor 


End of common block task build at 11250:43 om 21-JAN-82 
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Start of privileged task build at 11350243 on 21-JAN-82 


Note that the following tasks will be built for your system: 


5 

; 

; 

, 

; 

; 

g 

, BOO DMO coT FCPMDL ICF INT INS 
Dy FMT MCR DCL MOU QuG QMGCLI QMGFRT 
a] LFP FilMSG MTAACP SAV TKTN UFD LOA 
oF UNL PME RMD SHF ACNT BYE HEL 

, ERO SHUTUP ACS ERRLOG ELI 

? 

; 

, 

g 

; 

; 


It is assumed that Cls1lJFCSRES.STB is an ANSLIB version of the FCS 
resident library ~ 


ne 
oy 


-) Creating the task build .CMD and .ODL files in SYiC1:24] 


“ge 

*TKB @SY¢Cis24]RO0RBLD.CMD 
STKE @SY$Ci»24]0MOBLDO.CMD 
TRE @SYSC1»24I]COTRESBLD.CMD 
TRB @SY3C1s24]FCFPMDLELD. CAL 
“TRE @SY;Ci»24JICPBLE. Cho 
@SYiCis247INIBLD.CMD 
@Sy:Cirv24]INSBLO.CMD 
@SY:Cis24IFMTRLD. CMD 
@SY;Cis24]MCMHELD.CMD 
@SY:Ci,s24]0CLBLD.CME 
@SY3;Ci»s24]MOUBLD.CMD 
@SY+Cis24]QMGRESBLO.C:-D 
E @SY3C1l»24JQCLRESBLDI.CME 
STRB @SY3C1»243IQFRBLD.CME 
“TRE @SYiCis24ILPPRESBLE. CMD 


2 @SY:Cis24]F11MSGBLI.CMD 
STKE @SY¢Cis24I]MTABLD. CMD 
“TRE @SY2Cis24]SAVELD.CMD 
STRE @SYiC1L, 24] TKNBLOE. CMD 
STKE @SY$Ci,+24]UFDBLE. CME 
STRE @SYi$Ci»24I]L0ABLD.CHD 
“TRB @SYiCi»s24]UNLRESBLD.CMD 
PTRE @SYiCLs24IPMDRESBLD.CMD 
“TRE @SYiC1,24]RMDBLD. CME 
“TRE @SY?$Ci,s24)SHFBLD. CMD 
STRBE @SY3C1»s24JACNRESBLI.CME 
PIKE @SYi$Cis24]BYEBLD.CMD 
STKE @SY$C1is24]HELRESBLO. CHD 
2TRB @SY¢Cis247RBROBLE.CMD 
>TRE @SY$C1,24]SHUBLD.CMD 
“TRE @SYiCi»s24]ACSRESBLD.CMD 
STKB @SY:Ci,s24]ERLBLD. CME 
“TKB @SY2Cils24JELIRESBLI. CMD 


End of privileged task build at 12331243 om 21-JAN-82 


Start of system VMR at 12!31143 om 21-JAN-82 


<a ED BD ep OD wor 


wot ee 


>SET /UIC=C1954] 


Se 

ZASN SY?=LB? 

>VMR @SYSVMR 

VMR -- *DIAGK-Partition reduced to executive common size 


1/82 EXAMPLE INSTALLATION 


INS EXCOM1 


UM -- KDTAGK-Fartition reduced to executive common size 

INS EXC 2 

UMR -- XDIAG¥-Loadable driver larger than 4K 

LOA TT: 

VMR -- ¥DIAGK-Installed tasks may no longer fit in rartition 


SET /TOFS=DRVFARS: -x 

FOOL=1200: 9020. 209020. 

EXCOM1 117734 00120000 00014700 MAIN COM 

EXCOM2 1174670 00134700 00006700 MAIN COM 

LIRFAR 117624 00143600 00002600 MAIN TASK 

TTFAR 117260 001446400 00040000 MAIN TASK 

URVFAR 116734 90206400 000074600 MAIN SYS 
1146670 00206400 00003100 SUB DRIVER - Re 
116570 00211500 00004200 SUB DRIVER ~ MM: 
116470 00216000 00000200 SUR ODRIVER - COi 

SYSFAR 116424 00214200 000:0100 MAIN TASK 

FCSRES 116360 00226300 00031700 MAIN COM 

FCPRFAR 116314 00260200 00024000 MAIN SYS 

GEN 116250 00304200 02073600 MAIN SYS 

LUR« ++ 12.19 4117510 LORFAR 248. 00002600 LEO! -00229343 FIXED 

TKIN 04.8 111564 SYSFAR 248. 00010100 LEO} -090025422 


ee tRMD V1.O5 115110 GEN 225. 00027100 LBOt-00226557 
FLIMSG VO012 114200 GEN 200. 000054600 LBRO? -00223134 
MTAACF 0013 114064 GEN 200. 00014400 LEO?-00226412 
+++ 0MO 23.26 114544 GEN 160. 00014400 LBO;-00221072 
MCReae 2402 113040 SYSFAR 160. 00010100 LEO?{-90221172 
+e DCL 00 112724 GEN 149. 90037200 LEO? -00225421 
+e eMOU 2503 112244 GEN 140. 00037700 LEO! -06222730 
oo +MCR 1d 111706 GEN 160. 00020000 LEO? ~-00225233 — 
FLLACFE MO401 116134 FCFPRAR 147. 00924000 LBO!-00224554 
ERRLOG V1.05 114430 GEN 148. 90040000 LRO:?-O0013515¢08 
FMTs++ 01-52 113404 GEN 148. 00006300 LRO?-90221150 
COT.++ 01-02 116020 GEN 1435, 00014100 LBO:-90221111 
PMIte+. O72 113270 GEN 140. 00016700 LEO? -00226530 
SHF.+s 5-608 112014 SYSFAR 105. 00910100 LBOs-00223440 
e+¢INS 06 113520 GEN 100, 00034400 LEO?-90225174 
+e eSAV 2,18 11213060 GEN 100. 00033000 LBO?-O0224301 
++ UFD ¥9412 111450 GEN 100. 60005700 LBO}-00223150 
QMG... 1.8 115704 GEN 7%, 00032200 LEOF-O0223101 
FRTsee 12 1152340 GEN 70. 00001100 LB0:3-00221215 
LFO 1.10 115224 GEN 79+ 900014000 LBO%-00226204 
++vACS 01,02 114774 GEN 70. 90005700 LEO?-00130667 
+e eATs O2 113634 GEN 64. 000460000 LBRO} -00224711 
+o QUE 1,10 115570 GEN 50- 90020400 LEHO!-00226062 
oe eoFRI 1.10 115454 GEN SO. 00026600 LBRO: -00226902 
+++BO0 06.02 114660 GEN 50. 00021600 LhO?-00221031 
eo ELI YV1.03 114314 GEN 30. 00017700 LRO?-00131547 
oo +MAG 01.02 113750 GEN SO. 00031300 LBO?-002246071 
ee eLOA 03.3 113154 GEN SO. 00032300 LEO! -002246125 
e+ +HEL 01.0 112610 GEN 30. 00024100 LBRO? -00227021 
ee BYE 04-1 112474 GEN SO. 00012400 LEO$-00226757 
e++BRO V04 112360 GEN SO, 00030300 LBO:-00227064 
++eUNL 3.0 111334 GEN SO. 00024400 LEG!-00226343 
DROS: Loaded 

DRLs Loaded 

MMOS Loaded 

CoO: TTS? 

TTO3 Loaded 

TT1: Loaded 

TT23 Loaded 

TT33 Loaded 

TT4: Loaded 

TTS: Loaded 

TTé63 Loaded 

TT73 Loaded 
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P11gs Losden 
TTAL: Loaded 


TT123 Loaded 
TT13: Loaded 
TT142 Loaded 
TT1S2 Loaded 
TT163 Loaded 
TT172 Loaded 
TT203 Loaded 
NLO? 

TIO$ 


CLO: TTO? 
LBO? DRO: 
SYO: DRO} 


End of system VMR at 123233:51 on 21-JAN-82 


Ar alternate version of SYSLIB.OLB, the sustem obJect library, was 
i created to frovide surrort for ANSI magtare/FLS bis-buffering (which 
* vou selected in Fhase I). You may want to rebuild DMFs FLX. FIP, and 
i VFY in Phase III to use ANSLIB.OLB. Notes howevers building tasks with 
°9 ANSLIB,OLB causes an increase in the size of tasks es comrered to the 
“* SYSLIB.OLR version of the tasks. 
* 
y 
g 


A memory resident library of FCS routines (which you selected in Fhase J) 
was built to hele reduce task memory reavirements, You maz wank to rabud 


sy tasks in Fhase III to link to the FCS resident library. 
Oey 
“> When SYSGEN finishes, boot in wour tardet systems end save the system wit 
er bootstrar., For example! 
my 
Bo ROO CivsS4IRSX1iM ~ 
Be XUT? 32 \ 
”y , ; 
a] XUTsG 
ne RSX11M V4.0 BL32 
we 
ar 
a °TIM 11323 14-OCT-81 
hy “SAV /WE 
hy 
cae] RSX11M V4.0 BL32 320,.K MAFFED 
By SRED DRS =SY3 
BS SRED DOR¢=LBE 
Dy >MOU DRS RSXM32 
PS 2@DUR?C1s23STARTUP 
my ° 
se ‘ 
: y e 
og 
PASN =LB3 
y 
» End of SYSGEN fehase II at 12:34:00 on 21-JAN-82 
Dy 
“SET /UIC=£2002200] 
@ “EOF: 


°BOO CisS4IRSX11M 


1/82 EXAMPLE INSTALLATION H-9 


SET /UIC=C1i172] 
“@FMONBLOD 
Se ENTER KWi1-P VECTOR ADDRESS CO Ri100-774 03104); 
“ok ENTER KW11-P CSR ADDRESS CO R2160000-177776 Di172540); 
“% WILL THE BUFFERS BE IN A STATIC FARTITION? CY/NI: 
*TKB @COLBLD 
’TKB @TRMBLD 
“TKB @COLMSGBLD 
YSET /UIC=C1954] 
>TKE @Ciits2]QFDRVBLD 
“SET /UIC=C1192] 


Taskbuild the MIR» OVL & CLF Frodgrams. 
EIS or FRE <FFP> €S]73 

Ilo vou wish to build the task OVL? CY/N]: 
Ilo sou wish to build the task CLF? CY/NI: 


; 
3 
; 
x 
’ 
x 
; 

ee, 

oo 

“* Lo you wish to build the task MIR? CY/NI: Y 
K Build Overlaid Version of MDR.TSK? CY/NI: Y 

“* Do gou want to edit the MIR taskbuild command file? CY/N1]: 

>TRKB @MDORFFFOVL 
@ <EQF> 

’INS COL 

>INS TRM 

“INS COLMSG i 

»yLOA QF3/FAR=GEN/HIGH 

2’ INS OVL 

“INS CLF 

2INS MOR 

2 INS DRS 
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as +> 


